Compartilhar via


LSA_CRACK_SINGLE_NAME função de retorno de chamada (ntsecpkg.h)

A função CrackSingleName converte um nome de um formato para outro.

Sintaxe

LSA_CRACK_SINGLE_NAME LsaCrackSingleName;

NTSTATUS LsaCrackSingleName(
  [in]           ULONG FormatOffered,
  [in]           BOOLEAN PerformAtGC,
  [in]           PUNICODE_STRING NameInput,
  [in, optional] PUNICODE_STRING Prefix,
  [in]           ULONG RequestedFormat,
  [out]          PUNICODE_STRING CrackedName,
  [out]          PUNICODE_STRING DnsDomainName,
  [out]          PULONG SubStatus
)
{...}

Parâmetros

[in] FormatOffered

O formato do nome de entrada. A tabela a seguir contém os valores válidos para esse parâmetro.

Valor Significado
DS_CANONICAL_NAME
Nome canônico completo (por exemplo, example.microsoft.com/software/someone). A versão somente de domínio inclui uma barra (/) à direita.
DS_CANONICAL_NAME_EX
O mesmo que DS_CANONICAL_NAME exceto que a barra (/) mais à direita é substituída por um caractere de nova linha (\n), mesmo em um caso somente de domínio (por exemplo, example.microsoft.com/software\nalguém).
DS_DISPLAY_NAME
Um nome de exibição "amigável". O nome de exibição não é necessariamente o RDN ( nome diferenciado relativo ) definidor.
DS_FQDN_1779_NAME
Nome diferenciado totalmente qualificado (por exemplo, CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com).
DS_NT4_ACCOUNT_NAME
Nome da conta do Windows (por exemplo, Exemplo\Nome). A versão somente de domínio inclui barras invertidas à direita (\\).
DS_SERVICE_PRINCIPAL_NAME
Nome da entidade de serviço generalizada (por exemplo, www/www.microsoft.com@microsoft.com).
DS_SID_OR_SID_HISTORY_NAME
Um SID ( identificador de segurança ) para o objeto. Pode ser o SID atual ou um SID do histórico de SID do objeto. A cadeia de caracteres SID pode usar a representação de cadeia de caracteres padrão de um SID ou uma das constantes de cadeia de caracteres definidas em Sddl.h. Para obter informações sobre como converter um SID binário em uma cadeia de caracteres SID, consulte Cadeias de caracteres sid. Esse valor não é válido para o parâmetro formatDesired .
DS_UNIQUE_ID_NAME
Cadeia de caracteres GUID retornada pela função IIDFromString (por exemplo, {4fa050f0-f561-11cf-bdd9-00aa003a77b6}).
DS_UNKNOWN_NAME
Tipo de nome desconhecido.
DS_USER_PRINCIPAL_NAME
Nome principal do usuário (por exemplo, someone@example.microsoft.com).

[in] PerformAtGC

Especifica se a tradução deve ser executada em um servidor de catálogo global.

[in] NameInput

Um ponteiro para uma estrutura UNICODE_STRING que contém o nome a ser convertido.

[in, optional] Prefix

Um ponteiro para uma estrutura UNICODE_STRING que especifica um prefixo para o nome.

[in] RequestedFormat

O formato solicitado do nome rachado. Para obter uma lista de valores válidos, consulte o parâmetro FormatOffered .

[out] CrackedName

Um ponteiro para uma estrutura UNICODE_STRING que recebe o nome reformatado.

[out] DnsDomainName

Um ponteiro para uma estrutura UNICODE_STRING que recebe o nome do domínio que possui o nome especificado pelo parâmetro NameInput .

[out] SubStatus

Um ponteiro para uma variável que recebe informações adicionais sobre o valor retornado da chamada de função.

Retornar valor

Se a função for bem-sucedida, a função retornará STATUS_SUCCESS.

Se a função falhar, ela retornará STATUS_UNSUCCESSFUL. Para obter mais informações, consulte o valor retornado no parâmetro SubStatus .

Comentários

Um ponteiro para a função CrackSingleName está disponível na estrutura LSA_SECPKG_FUNCTION_TABLE recebida pela função SpInitialize .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecpkg.h

Confira também

LSA_SECPKG_FUNCTION_TABLE

SpInitialize