 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. |
This structure is used to identify a remote machine resource to the new or enhanced activation functions.
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 actual client will be used. To meet any one 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 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 pAuthInfois 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 pAuthInfomember is not specified, any values in the AppIDsection 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
Requirements
Runs On Versions Defined in Include Link to Windows CE OS 2.0 and later Wtypes.h Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also