Função RpcServerInqDefaultPrincName (rpcdce.h)

A função RpcServerInqDefaultPrincName obtém o nome da entidade de segurança padrão para um determinado serviço de autenticação.

Sintaxe

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

Parâmetros

AuthnSvc

Serviço de autenticação a ser usado quando o servidor recebe uma solicitação para uma chamada de procedimento remoto.

PrincName

Após o êxito, contém o nome da entidade de segurança padrão para o serviço de autenticação especificado pelo parâmetro AuthnSvc . O serviço de autenticação em uso define o conteúdo do nome e sua sintaxe. Esse nome principal deve ser usado como o parâmetro ServerPrincName da função RpcServerRegisterAuthInfo . Se a função for bem-sucedida, PrincName deverá ser liberado usando a função RpcStringFree . Se a função falhar, o conteúdo de PrincName será indefinido e o chamador não terá obrigação de liberá-lo.

Valor retornado

Comentários

Essa função é a maneira recomendada de obter o nome da entidade de segurança do servidor a ser passado para a função RpcServerRegisterAuthInfo . Embora a composição do nome da entidade de segurança do servidor seja possível sem usar essa função, chamar a função é mais fácil e portátil entre as versões do sistema operacional.

Requisitos

Confira também

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo