Funzione DsCrackUnquotedMangledRdnA (dsparse.h)

Articolo
08/23/2023

La funzione DsCrackUnquotedMangledRdn unmangles (unencodes) un determinato nome distinto relativo e restituisce sia il GUID decodificato che il tipo di mangling 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 non racchiusi travii, vedere DsUnquoteRdnValue.

[in] cchRDN

Contiene la lunghezza, in caratteri, della stringa pszRDN .

[out, optional] pGuid

Puntatore al valore GUID 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 ricevono dati.

Commenti

Questa funzione tenta di decodificare (annullare) un RDN precedentemente mangled 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 è mangled, 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsparse.h (include Ntdsapi.h)
Libreria	Ntdsapi.lib
DLL	Ntdsapi.dll