Función DsCrackUnquotedMangledRdnA (dsparse.h)
El DsCrackUnquotedMangledRdn función unmangles (uncodes) un nombre distintivo relativo determinado y devuelve el GUID descodificado y el tipo de mangling usado.
Sintaxis
DSPARSE BOOL DsCrackUnquotedMangledRdnA(
[in] LPCSTR pszRDN,
[in] DWORD cchRDN,
[out, optional] GUID *pGuid,
[out, optional] DS_MANGLE_FOR *peDsMangleFor
);
Parámetros
[in] pszRDN
Puntero a una cadena que contiene el nombre distintivo relativo (RDN) que se va a traducir. Esta longitud de cadena se especifica mediante el parámetro cchRDN, por lo que no es necesario que esta cadena finalice en null. Esta cadena debe estar en forma sin comilla. Para obtener más información sobre los nombres distintivos relativos sin comillas, vea DsUnquoteRdnValue.
[in] cchRDN
Contiene la longitud, en caracteres, de la cadena de pszRDN.
[out, optional] pGuid
Puntero a guid valor que recibe el GUID del nombre distintivo relativo no administrado. Este parámetro puede ser null.
[out, optional] peDsMangleFor
Puntero a un valor de DS_MANGLE_FOR que recibe el tipo de mangling usado en el nombre distintivo relativo mangled. Este parámetro puede ser null.
Valor devuelto
Esta función devuelve TRUE si el nombre distintivo relativo se administra o FALSE de lo contrario. Si esta función devuelve FALSE, ni pGuid ni peDsMangleFor reciben datos.
Observaciones
Esta función intenta descodificar (unmangle) un RDN que se ha administrado previamente debido a una eliminación o a un conflicto de nomenclatura. Si se administra el nombre distintivo relativo, la función devuelve TRUE y recupera el GUID y el tipo de mangle, si se solicita. Si el nombre distintivo relativo no está ordenado, la función devuelve FALSE.
Nota
El encabezado dsparse.h define DsCrackUnquotedMangledRdn como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista |
| servidor mínimo admitido | Windows Server 2008 |
| de la plataforma de destino de |
Windows |
| encabezado de |
dsparse.h (incluya Ntdsapi.h) |
| biblioteca de |
Ntdsapi.lib |
| DLL de |
Ntdsapi.dll |
Consulte también
controlador de dominio y funciones de administración de replicación