Función RpcMgmtInqServerPrincName (rpcdce.h)

  • Artículo

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

Sintaxis

RPC_STATUS RpcMgmtInqServerPrincName(
  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 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.
 

Comentarios

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 RpcStringFree para liberar la memoria usada por esta función.

El servidor debe escuchar las llamadas a procedimiento remoto para que esta función se realice correctamente. Si el servidor no está escuchando, se produce un error en la función.

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]
Plataforma de destino Windows
Encabezado rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcStringFree