COSERVERINFO

[This is preliminary documentation and subject to change.]

Identifies a remote machine resource to the new or enhanced activation functions. The structure is defined as follows in the Wtypes.h header file:

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

Members

dwReserved1: Reserved for future use. Must be 0.
pwszName: Pointer to the name of the machine to be used.
pAuthInfo: Set to a pointer to a COAUTHINFO structure 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. Must be 0.

Remarks

The COSERVERINFO structure 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 ("\\server" or "server") and DNS names ("server.com", "www.foo.com", or "135.5.33.19") names are allowed.

If pAuthInfo is set to NULL, NTLMSSP with the identity of the actual client will be used. To meet any one of the needs in the following list, pAuthInfo can be set to point to a non-NULL COAUTHINFO structure:

To specify a different client identity for machine remote activations. The specified identity will be 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 may or may not be specified.
To request unsecure activation.
To specify a proprietary authentication service.

If pAuthInfo is not NULL, those values will be used to specify the authentication settings for the remote call. These settings will be passed to RpcBindingSetAuthInfoEx.

If the pAuthInfo parameter is not specified, any values in the AppID section of the registry will be used to override the following default authentication settings:

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

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.

COSERVERINFO

Members

Remarks

QuickInfo

See Also