Funzione DsCrackUnquotedMangledRdnA (dsparse.h)
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 |
Vedi anche
Funzioni di gestione del controller di dominio e della replica