Función RpcServerInqDefaultPrincName (rpcdce.h)

  • Artículo

La función RpcServerInqDefaultPrincName obtiene el nombre principal predeterminado para un servicio de autenticación determinado.

Sintaxis

RPC_STATUS RpcServerInqDefaultPrincName(
  unsigned long AuthnSvc,
  RPC_WSTR      *PrincName
);

Parámetros

AuthnSvc

Servicio de autenticación que se usará cuando el servidor recibe una solicitud de una llamada a procedimiento remoto.

PrincName

Tras la operación correcta, contiene el nombre principal predeterminado para el servicio de autenticación especificado por el parámetro AuthnSvc . El servicio de autenticación en uso define el contenido del nombre y su sintaxis. Este nombre principal debe usarse como parámetro ServerPrincName de la función RpcServerRegisterAuthInfo . Si la función se ejecuta correctamente, PrincName debe liberarse mediante la función RpcStringFree . Si se produce un error en la función, el contenido de PrincName no está definido y el autor de la llamada no tiene ninguna obligación de liberarlo.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_OUT_OF_MEMORY
 No hay memoria suficiente para completar la operación.
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

Esta función es la manera recomendada de obtener el nombre principal del servidor que se va a pasar a la función RpcServerRegisterAuthInfo . Aunque la composición del nombre principal del servidor es posible sin usar esta función, llamar a la función es más fácil y más portátil en las versiones del sistema operativo.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo