DsCrackUnquotedMangledRdnA-Funktion (dsparse.h)
Die DsCrackUnquotedMangledRdn Funktion unmangles (unencodes) einen bestimmten relativen distinguishierten Namen und gibt sowohl die decodierte GUID als auch den verwendeten Manglingtyp zurück.
Syntax
DSPARSE BOOL DsCrackUnquotedMangledRdnA(
[in] LPCSTR pszRDN,
[in] DWORD cchRDN,
[out, optional] GUID *pGuid,
[out, optional] DS_MANGLE_FOR *peDsMangleFor
);
Parameter
[in] pszRDN
Zeigen Sie auf eine Zeichenfolge, die den zu übersetzenden relativen Distinguished Name (RDN) enthält. Diese Zeichenfolgenlänge wird durch den cchRDN--Parameter angegeben, sodass diese Zeichenfolge nicht null-beendet werden muss. Diese Zeichenfolge muss in nicht angehaltener Form sein. Weitere Informationen zu nicht zitierten relativen Distinguished Names finden Sie unter DsUnquoteRdnValue.
[in] cchRDN
Enthält die Länge der pszRDN- Zeichenfolge in Zeichen.
[out, optional] pGuid
Zeigen Sie auf GUID- Wert, der die GUID des nicht verwalteten relativen Distinguished-Namens empfängt. Dieser Parameter kann NULL-sein.
[out, optional] peDsMangleFor
Zeigen Sie auf einen DS_MANGLE_FOR Wert, der den Typ der im mangled relativen Distinguished-Namen verwendeten Mangling-Typ empfängt. Dieser Parameter kann NULL-sein.
Rückgabewert
Diese Funktion gibt TRUE zurück, wenn der relative Distinguished Name gegled oder FALSE ist. Wenn diese Funktion FALSE-zurückgibt, werden weder pGuid noch peDsMangleFor Daten empfangen.
Bemerkungen
Diese Funktion versucht, ein RDN zu decodieren (unmangle), das zuvor aufgrund eines Löschvorgangs oder eines Namenskonflikts verworren wurde. Wenn der relative Distinguished Name gegled wird, gibt die Funktion TRUE zurück und ruft die GUID und den Umschlagtyp bei Bedarf ab. Wenn der relative Distinguished-Name nicht verworren ist, gibt die Funktion FALSEzurück.
Anmerkung
Der dsparse.h-Header definiert DsCrackUnquotedMangledRdn als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Fenster |
| Header- | dsparse.h (include Ntdsapi.h) |
| Library | Ntdsapi.lib |
| DLL- | Ntdsapi.dll |