Función RpcMgmtInqServerPrincNameW (rpcdce.h)

La función RpcMgmtInqServerPrincName devuelve el nombre principal de un servidor.

Sintaxis

RPC_STATUS RpcMgmtInqServerPrincNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      AuthnSvc,
  RPC_WSTR           *ServerPrincName
);

Parámetros

Binding

Para recibir el nombre principal de un servidor, especifique un identificador de enlace de servidor para ese servidor. Para recibir el nombre principal de su propia aplicación (local), especifique un valor de NULL.

AuthnSvc

Servicio de autenticación para el que se devuelve un nombre de entidad de seguridad. Los valores válidos son la constante para cualquier proveedor de seguridad válido.

ServerPrincName

Devuelve un nombre de entidad de seguridad registrado para el servicio de autenticación en AuthnSvc por el servidor al que hace referencia en Binding. Si se registran varios nombres, solo se devuelve un nombre.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_INVALID_BINDING	El identificador de enlace no era válido.
RPC_S_WRONG_KIND_OF_BINDING	Este era el tipo incorrecto de enlace para la operación.

 

Nota Para obtener una lista de códigos de error válidos, vea rpc Return Values.

 

Observaciones

Una aplicación llama a la función RpcMgmtInqServerPrincName para obtener el nombre principal de un servidor registrado para un servicio de autenticación especificado.

La biblioteca en tiempo de ejecución rpc asigna memoria para la cadena devuelta en ServerPrincName. La aplicación es responsable de llamar a la función de RpcStringFree para liberar la memoria usada por esta función.

El servidor debe escuchar las llamadas a procedimientos remotos para que esta función se realice correctamente. Si el servidor no escucha, se produce un error en la función.

Nota

El encabezado rpcdce.h define RpcMgmtInqServerPrincName como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
de la plataforma de destino de	Windows
encabezado de	rpcdce.h (include Rpc.h)
biblioteca de	Rpcrt4.lib
DLL de	Rpcrt4.dll

Consulte también

RpcStringFree