COSERVERINFO-Struktur (objidl.h)

Artikel
02/29/2024

Identifiziert eine Remotecomputerressource mit den 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 Remoteaktivierungen des Computers 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 in erster Linie 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. Für pAuthInfo kann jedoch eine COAUTHINFO-Struktur ohne NULL angegeben werden, um eine der folgenden Anforderungen zu erfüllen:

So geben Sie eine andere Clientidentität für Remoteaktivierungen des Computers an. Die angegebene Identität wird für die Überprüfung der Startberechtigung auf dem Server anstelle der echten Clientidentität verwendet.
Um anzugeben, dass Kerberos anstelle von NTLMSSP für die Remoteaktivierung des Computers verwendet wird. Eine nicht standardmäßige Clientidentität kann angegeben werden oder 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. Für frühere 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	objidl.h (include Objidl.h)