Função GetTrusteeNameA (aclapi.h)

A função GetTrusteeName recupera o nome do administrador da estrutura TRUSTEE especificada.

Sintaxe

LPSTR GetTrusteeNameA(
  [in] PTRUSTEE_A pTrustee
);

Parâmetros

[in] pTrustee

Um ponteiro para uma estrutura TRUSTEE.

Valor de retorno

Se o TrusteeForm membro da estrutura TRUSTEE for TRUSTEE_IS_NAME, o valor retornado será o ponteiro atribuído ao ptstrName membro da estrutura.

Se o membro TrusteeForm for TRUSTEE_IS_SID, o valor retornado será NULL. A função não pesquisa o nome associado a um SID (identificador de segurança) .

Observações

A função GetTrusteeName não aloca nenhuma memória.

Nota

O cabeçalho aclapi.h define GetTrusteeName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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 XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	aclapi.h
biblioteca	Advapi32.lib
de DLL	Advapi32.dll

Consulte também

Visão geral do controle de acesso

funções básicas de controle de acesso

SID

do TRUSTEE