Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure is used to identify a remote machine resource to the new or enhanced activation functions.

Syntax 

typedef struct _COSERVERINFO {
  DWORD 
dwReserved1;
  LPWSTR 
pwszName;
  COAUTHINFO* 
pAuthInfo;
  DWORD 
dwReserved2;
} COSERVERINFO;

Members

dwReserved1

Reserved for future use; set to zero.

pwszName

Pointer to the name of the machine to be used.

pAuthInfo

Set to a pointer to a COAUTHINFOstructure to override the default activation security for machine remote activations. Otherwise, set to NULL to indicate that default values should be used.

For more information, see the Remarks section.

dwReserved2

Reserved for future use; set to zero.

Remarks

The COSERVERINFOstructure is used primarily to identify a remote system in object creation functions.

Machine resources are named using the naming scheme of the network transport. By default, all UNC and DNS names are allowed.

If pAuthInfois set to NULL, NTLMSSP with the identity of the client will be used. To meet any of the needs in the following list, pAuthInfocan be set to point to a non-NULL COAUTHINFOstructure:

  • To specify a different client identity for machine remote activations. The specified identity is used for the launch permission check on the server rather than the real client identity.

  • To specify that Kerberos, rather than NTLMSSP, is used for machine remote activation. A nondefault client identity might or might not be specified.

  • To request unsecure activation.

  • To specify a proprietary authentication service.

If pAuthInfois not NULL, those values are used to specify the authentication settings for the remote call. These settings are passed to RpcBindingSetAuthInfoEx.

If the pAuthInfomember is not specified, values in the AppIDsection of the registry are used to override default authentication settings.

The following table shows the settings that are overridden.

pAhuthInfo member Setting

dwAuthnSvc

RPC_C_AUTHN_WINNT

dwAuthzSvc

RPC_C_AUTHZ_NONE

pszServerPrincName

NULL

dwAuthnLevel

RPC_C_AUTHN_LEVEL_CONNECT

dwImpersonationLevel

RPC_C_IMP_LEVEL_IMPERSONATE

pvAuthIdentityData

NULL

dwCapabilities

RPC_C_QOS_CAPABILITIES_DEFAULT

Requirements

Header wtypes.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

COAUTHINFO