Função RpcServerInqDefaultPrincNameW (rpcdce.h)

Artigo
11/20/2024

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 RpcServerInqDefaultPrincNameW(
  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 de do 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 do PrincName será indefinido e o chamador não terá obrigação de liberá-la.

Valor de retorno

Valor	Significado
RPC_S_OK	A chamada foi bem-sucedida.
RPC_S_OUT_OF_MEMORY	Não há memória suficiente para concluir a operação.

Observação Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Observações

Essa função é a maneira recomendada de obter o nome da entidade de segurança do servidor a ser passada 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 em versões do sistema operacional.

Nota

O cabeçalho rpcdce.h define RpcServerInqDefaultPrincName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	rpcdce.h (inclua Rpc.h)
biblioteca	Rpcrt4.lib
de DLL	Rpcrt4.dll

Consulte também

RpcBindingSetAuthInfo

RpcServerRegisterAuthInfo

Compartilhar via