COSERVERINFO

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

At a Glance

Header file: Wtypes.h
Windows CE versions: 2.0 and later

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 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; set to zero.

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 and DNS 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:

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 member 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