COSERVERINFO-Struktur (objidlbase.h)

Artikel
03/13/2024

Identifiziert eine Remotecomputerressource für die Aktivierungsfunktionen.

Syntax

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

Member

dwReserved1

Dieser Member ist reserviert und muss 0 sein.

pwszName

Der Name des Computers.

pAuthInfo

Ein Zeiger auf eine COAUTHINFO-Struktur , um die Standardaktivierungssicherheit für Computer-Remoteaktivierungen außer Kraft zu setzen. Legen Sie andernfalls auf NULL fest, um anzugeben, dass Standardwerte verwendet werden sollen. Weitere Informationen finden Sie im Abschnitt mit Hinweisen.

dwReserved2

Dieser Member ist reserviert und muss 0 sein.

Hinweise

Die COSERVERINFO-Struktur wird hauptsächlich verwendet, um ein Remotesystem in Objekterstellungsfunktionen zu identifizieren. Computerressourcen werden mithilfe des Benennungsschemas des Netzwerktransports benannt. Standardmäßig sind alle UNC-Namen ("\\server" oder "Server") und DNS-Namen ("Domain.com", "example.microsoft.com" oder "135.5.33.19") zulässig.

Wenn pAuthInfo auf NULL festgelegt ist, wird Snego verwendet, um einen Authentifizierungsdienst auszuhandeln, der zwischen Client und Server funktioniert. Allerdings kann eine COAUTHINFO-Struktur ungleich NULL für pAuthInfo angegeben werden, um eine der folgenden Anforderungen zu erfüllen:

Angeben einer anderen Clientidentität für Computer-Remoteaktivierungen Die angegebene Identität wird für die Überprüfung der Startberechtigung auf dem Server anstelle der echten Clientidentität verwendet.
Geben Sie an, dass Kerberos anstelle von NTLMSSP für die Remoteaktivierung des Computers verwendet wird. Eine nicht standardmäßige Clientidentität kann angegeben werden oder auch nicht.
Um eine unsichere Aktivierung anzufordern.
So geben Sie einen proprietären Authentifizierungsdienst an.

Wenn pAuthInfo nicht NULL ist, werden diese Werte verwendet, um die Authentifizierungseinstellungen für den Remoteaufruf anzugeben. Diese Einstellungen werden an die Funktion RpcBindingSetAuthInfoEx übergeben.

Wenn der pAuthInfo-ParameterNULL ist, kann dwAuthnLevel durch die von der CoInitializeSecurity-Funktion festgelegte Authentifizierungsebene überschrieben werden. Wenn die CoInitializeSecurity-Funktion nicht aufgerufen wird, wird die unter dem AppID-Registrierungsschlüssel angegebene Authentifizierungsebene verwendet, sofern vorhanden.

Ab Windows XP mit Service Pack 2 (SP2) ist dwAuthnLevel das Maximum an RPC_C_AUTHN_LEVEL_CONNECT und die prozessweite Authentifizierungsebene des Clientprozesses, der die Aktivierungsanforderung ausgibt. Bei früheren Versionen des Betriebssystems ist dies RPC_C_AUTHN_LEVEL_CONNECT.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps \| UWP-Apps]
Kopfzeile	objidlbase.h (include Objidl.h)