COSERVERINFO 結構 (objidl.h)

發行項
02/29/2024

識別啟用函式的遠端計算機資源。

語法

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

成員

dwReserved1

這個成員是保留的，而且必須是 0。

pwszName

電腦的名稱。

pAuthInfo

COAUTHINFO 結構的指標，可覆寫計算機遠端啟用的默認啟用安全性。否則，請將設定為 NULL ，表示應該使用預設值。如需詳細資訊，請參閱＜備註＞一節。

dwReserved2

這個成員是保留的，而且必須是 0。

備註

COSERVERINFO 結構主要用於識別物件建立函式中的遠端系統。計算機資源是使用網路傳輸的命名配置來命名。根據預設，允許所有 UNC (“\\server” 或 “server”) 和 DNS 名稱 (“domain.com”、“example.microsoft.com” 或 “135.5.33.19”) 名稱。

如果 pAuthInfo 設定為 NULL，Snego 將用來交涉在用戶端與伺服器之間運作的驗證服務。不過，可為 pAuthInfo 指定非 NULLCOAUTHINFO 結構，以符合下列任何一項需求：

指定電腦遠端啟用的不同用戶端身分識別。指定的身分識別將用於伺服器上的啟動許可權檢查，而不是實際的用戶端身分識別。
若要指定 Kerberos，而不是 NTLMSSP，會用於電腦遠端啟用。非預設用戶端身分識別可能或未指定。
要求不安全的啟用。
指定專屬驗證服務。

如果 pAuthInfo 不是 NULL，這些值將用來指定遠端呼叫的驗證設定。這些設定會傳遞至 RpcBindingSetAuthInfoEx 函式。

如果 pAuthInfo 參數為 NULL，則 CoInitializeSecurity 函式所設定的驗證層級可以覆寫 dwAuthnLevel。如果未呼叫 CoInitializeSecurity 函式，則會使用 AppID 登錄機碼下指定的驗證層級，如果有的話。

從 Windows XP 搭配 Service Pack 2 (SP2) 開始， dwAuthnLevel 是發出啟用要求之用戶端程式的最多RPC_C_AUTHN_LEVEL_CONNECT和整個進程驗證層級。針對舊版的操作系統，這會RPC_C_AUTHN_LEVEL_CONNECT。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
標頭	objidl.h (包含 Objidl.h)