Funzione DsCrackUnquotedMangledRdnA (dsparse.h)

Articolo
11/20/2024

Il DsCrackUnquotedMangledRdn funzione unmangles (unencodes) un determinato nome distinto relativo e restituisce sia il GUID decodificato che il tipo di maschera utilizzato.

Sintassi

DSPARSE BOOL DsCrackUnquotedMangledRdnA(
  [in]            LPCSTR        pszRDN,
  [in]            DWORD         cchRDN,
  [out, optional] GUID          *pGuid,
  [out, optional] DS_MANGLE_FOR *peDsMangleFor
);

Parametri

[in] pszRDN

Puntatore a una stringa contenente il nome distinto relativo (RDN) da tradurre. Questa lunghezza della stringa viene specificata dal parametro cchRDN , pertanto questa stringa non deve essere terminata con null. Questa stringa deve essere in formato non racchiuso tra virgolette. Per altre informazioni sui nomi distinti relativi senza virgocolo, vedere DsUnquoteRdnValue.

[in] cchRDN

Contiene la lunghezza, in caratteri, della stringa pszRDN.

[out, optional] pGuid

Puntatore a GUID valore che riceve il GUID del nome distinto relativo non gestito. Questo parametro può essere NULL.

[out, optional] peDsMangleFor

Puntatore a un valore DS_MANGLE_FOR che riceve il tipo di mangling utilizzato nel nome distinto relativo mangled. Questo parametro può essere NULL.

Valore restituito

Questa funzione restituisce true se il nome distinto relativo è mangled o FALSE in caso contrario. Se questa funzione restituisce FALSE, né pGuid né peDsMangleFor ricevere dati.

Osservazioni

Questa funzione tenta di decodificare (annullare la decodifica) di un RDN precedentemente ingrandato a causa di un'eliminazione o di un conflitto di denominazione. Se il nome distinto relativo è mangled, la funzione restituisce TRUE e recupera il GUID e il tipo di mangle, se richiesto. Se il nome distinto relativo non viene sbrogliato, la funzione restituisce FALSE.

Nota

L'intestazione dsparse.h definisce DsCrackUnquotedMangledRdn come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows Vista
server minimo supportato	Windows Server 2008
piattaforma di destinazione	Finestre
intestazione	dsparse.h (include Ntdsapi.h)
libreria	Ntdsapi.lib
dll	Ntdsapi.dll

Vedere anche

DS_MANGLE_FOR

controller di dominio e funzioni di gestione della replica

DsIsMangledDn

DsIsMangledRdnValue

DsUnquoteRdnValue

Condividi tramite