Estructura COSERVERINFO (objidl.h)

Artículo
08/25/2023

Identifica un recurso de equipo remoto a las funciones de activación.

Sintaxis

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

Miembros

dwReserved1

Este miembro está reservado y debe ser 0.

pwszName

Nombre del equipo.

pAuthInfo

Puntero a una estructura COAUTHINFO para invalidar la seguridad de activación predeterminada para las activaciones remotas de la máquina. De lo contrario, establezca en NULL para indicar que se deben usar los valores predeterminados. Para obtener más información, vea la sección Comentarios.

dwReserved2

Este miembro está reservado y debe ser 0.

Comentarios

La estructura COSERVERINFO se usa principalmente para identificar un sistema remoto en las funciones de creación de objetos. Los recursos de equipo se denominan mediante el esquema de nomenclatura del transporte de red. De forma predeterminada, se permiten todos los nombres UNC ("\\server" o "servidor") y los nombres DNS ("dominio.com", "example.microsoft.com" o "135.5.33.19").

Si pAuthInfo está establecido en NULL, Snego se usará para negociar un servicio de autenticación que funcionará entre el cliente y el servidor. Sin embargo, se puede especificar una estructura COAUTHINFO que no sea NULL para que pAuthInfo satisfaga cualquiera de las siguientes necesidades:

Para especificar una identidad de cliente diferente para las activaciones remotas del equipo. La identidad especificada se usará para la comprobación de permisos de inicio en el servidor en lugar de la identidad de cliente real.
Para especificar que Kerberos, en lugar de NTLMSSP, se usa para la activación remota de la máquina. Una identidad de cliente no predeterminada puede especificarse o no.
Para solicitar la activación no segura.
Para especificar un servicio de autenticación propietario.

Si pAuthInfo no es NULL, esos valores se usarán para especificar la configuración de autenticación para la llamada remota. Esta configuración se pasará a la función RpcBindingSetAuthInfoEx .

Si el parámetro pAuthInfo es NULL, dwAuthnLevel se puede invalidar por el nivel de autenticación establecido por la función CoInitializeSecurity . Si no se llama a la función CoInitializeSecurity , se usa el nivel de autenticación especificado en la clave del Registro AppID , si existe.

A partir de Windows XP con Service Pack 2 (SP2), dwAuthnLevel es el máximo de RPC_C_AUTHN_LEVEL_CONNECT y el nivel de autenticación de todo el proceso del cliente que emite la solicitud de activación. En el caso de versiones anteriores del sistema operativo, esto es RPC_C_AUTHN_LEVEL_CONNECT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Encabezado	objidl.h (incluya Objidl.h)