COSERVERINFO 結構 (objidlbase.h)

發行項
03/05/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 應用程式]
標頭	objidlbase.h (包含 Objidl.h)