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 |
|---|---|
|
Nome canônico completo (por exemplo, example.microsoft.com/software/someone). A versão somente de domínio inclui uma barra (/) à direita. |
|
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). |
|
Um nome de exibição "amigável". O nome de exibição não é necessariamente o RDN ( nome diferenciado relativo ) definidor. |
|
Nome diferenciado totalmente qualificado (por exemplo, CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com). |
|
Nome da conta do Windows (por exemplo, Exemplo\Nome). A versão somente de domínio inclui barras invertidas à direita (\\). |
|
Nome da entidade de serviço generalizada (por exemplo, www/www.microsoft.com@microsoft.com). |
|
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 . |
|
Cadeia de caracteres GUID retornada pela função IIDFromString (por exemplo, {4fa050f0-f561-11cf-bdd9-00aa003a77b6}). |
|
Tipo de nome desconhecido. |
|
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 |