DsCrackUnquotedMangledRdnA-Funktion (dsparse.h)
Die DsCrackUnquotedMangledRdn-Funktion entmangle (entschlüsselt) einen bestimmten relativen distinguished-Namen und gibt sowohl die decodierte GUID als auch den verwendeten Typ für die Codierung 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
Zeiger auf eine Zeichenfolge, die den zu übersetzenden relativen distinguished Name (RDN) enthält. Diese Zeichenfolgenlänge wird vom cchRDN-Parameter angegeben, sodass diese Zeichenfolge nicht null-endend sein muss. Diese Zeichenfolge muss ohne Anführungszeichen vorliegen. Weitere Informationen zu relativen Distinguished-Namen ohne Anführungszeichen finden Sie unter DsUnquoteRdnValue.
[in] cchRDN
Enthält die Länge der pszRDN-Zeichenfolge in Zeichen.
[out, optional] pGuid
Zeiger auf den GUID-Wert , der die GUID des nicht verwalteten relativen Distinguished-Namens empfängt. Dieser Parameter kann NULL sein.
[out, optional] peDsMangleFor
Zeiger auf einen DS_MANGLE_FOR Wert, der den Typ der Mangling empfängt, der im verwalteten relativen Distinguished-Namen verwendet wird. Dieser Parameter kann NULL sein.
Rückgabewert
Diese Funktion gibt TRUE zurück, wenn der relative distinguished Name mangled oder FALSE ist. Wenn diese Funktion FALSE zurückgibt, erhalten weder pGuid noch peDsMangleFor Daten.
Hinweise
Mit dieser Funktion wird versucht, ein RDN zu decodieren (aufzuheben), das zuvor aufgrund eines Löschvorgangs oder namenskonflikts verwaltet wurde. Wenn der relative distinguished Name verwaltet wird, gibt die Funktion TRUE zurück und ruft bei Bedarf die GUID und den Mangletyp ab. Wenn der relative distinguished Name nicht verwaltet wird, gibt die Funktion FALSE zurück.
Hinweis
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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | dsparse.h (ntdsapi.h einschließen) |
| Bibliothek | Ntdsapi.lib |
| DLL | Ntdsapi.dll |