LSA_CRACK_SINGLE_NAME funzione di callback (ntsecpkg.h)

  • Articolo

La funzione CrackSingleName converte un nome da un formato a un altro.

Sintassi

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
)
{...}

Parametri

[in] FormatOffered

Formato del nome di input. La tabella seguente contiene i valori validi per questo parametro.

Valore Significato
DS_CANONICAL_NAME
 Completare il nome canonico, ad esempio example.microsoft.com/software/someone. La versione di sola dominio include una barra finale (/).
DS_CANONICAL_NAME_EX
 Uguale a DS_CANONICAL_NAME ad eccezione del fatto che la barra più a destra (/) viene sostituita con un carattere di nuova riga (\n), anche in caso di solo dominio (ad esempio, example.microsoft.com/software\nqualcuno).
DS_DISPLAY_NAME
 Nome visualizzato "descrittivo". Il nome visualizzato non è necessariamente il nome distinto relativo (RDN).
DS_FQDN_1779_NAME
 Nome distinto completo(ad esempio CN=NameOfPerson,OU=Users,DC=Example,DC=Fabrikam,DC=Com).
DS_NT4_ACCOUNT_NAME
 Nome account di Windows (ad esempio, Example\Name). La versione di sola dominio include barre rovesciata finali (\\).
DS_SERVICE_PRINCIPAL_NAME
 Nome dell'entità servizio generalizzata (ad esempio, www/www.microsoft.com@microsoft.com).
DS_SID_OR_SID_HISTORY_NAME
 Identificatore di sicurezza (SID) per l'oggetto. Può trattarsi del SID corrente o di un SID dalla cronologia SID dell'oggetto. La stringa SID può usare la rappresentazione di stringa standard di un SID o una delle costanti stringa definite in Sddl.h. Per informazioni sulla conversione di un SID binario in una stringa SID, vedere Stringhe SID. Questo valore non è valido per il parametro formatDesired .
DS_UNIQUE_ID_NAME
 Stringa GUID restituita dalla funzione IIDFromString , ad esempio {4fa050f0-f561-11cf-bdd9-00aa003a77b6}.
DS_UNKNOWN_NAME
 Tipo di nome sconosciuto.
DS_USER_PRINCIPAL_NAME
 Nome dell'entità utente (ad esempio, someone@example.microsoft.com).

[in] PerformAtGC

Specifica se eseguire la traduzione in un server di catalogo globale.

[in] NameInput

Puntatore a una struttura UNICODE_STRING che contiene il nome da convertire.

[in, optional] Prefix

Puntatore a una struttura UNICODE_STRING che specifica un prefisso per il nome.

[in] RequestedFormat

Formato richiesto del nome incriminato. Per un elenco di valori validi, vedere il parametro FormatOffered .

[out] CrackedName

Puntatore a una struttura UNICODE_STRING che riceve il nome riformattato.

[out] DnsDomainName

Puntatore a una struttura UNICODE_STRING che riceve il nome del dominio proprietario del nome specificato dal parametro NameInput .

[out] SubStatus

Puntatore a una variabile che riceve informazioni aggiuntive sul valore restituito della chiamata di funzione.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce STATUS_SUCCESS.

Se la funzione ha esito negativo, restituisce STATUS_UNSUCCESSFUL. Per altre informazioni, vedere il valore restituito nel parametro SubStatus .

Commenti

Un puntatore alla funzione CrackSingleName è disponibile nella struttura LSA_SECPKG_FUNCTION_TABLE ricevuta dalla funzione SpInitialize .

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecpkg.h

Vedi anche

LSA_SECPKG_FUNCTION_TABLE

SpInitialize