Función DsQuoteRdnValueA (dsparse.h)
La función DsQuoteRdnValue convierte un RDN en un valor RDN entre comillas, si el valor de RDN contiene caracteres que requieren comillas. A continuación, el RDN entrecomillado se puede enviar como parte de un nombre distintivo (DN) al servicio de directorio mediante varias API como LDAP. Un ejemplo de RDN que requeriría comillas sería una que tiene un valor separado por comas, como un RDN para un nombre que usa el formato "last,first".
Sintaxis
DSPARSE DWORD DsQuoteRdnValueA(
[in] DWORD cUnquotedRdnValueLength,
[in] LPCCH psUnquotedRdnValue,
[in, out] DWORD *pcQuotedRdnValueLength,
[out] LPCH psQuotedRdnValue
);
Parámetros
[in] cUnquotedRdnValueLength
Número de caracteres de la cadena psUnquotedRdnValue .
[in] psUnquotedRdnValue
Cadena que especifica el valor RDN sin comillas.
[in, out] pcQuotedRdnValueLength
Número máximo de caracteres de la cadena psQuotedRdnValue .
Las marcas siguientes son la salida de este parámetro.
ERROR_SUCCESS
Indica que se encontró el número correcto de caracteres en psQuotedRdnValue.
ERROR_BUFFER_OVERFLOW
Indica que el número de caracteres de la cadena no coincide con psQuotedRdnValue.
[out] psQuotedRdnValue
Cadena que recibe el valor convertido, y tal vez entrecomillado, RDN.
Valor devuelto
La lista siguiente contiene los valores posibles devueltos para la función DsQuoteRdnValue .
Comentarios
Las comillas no se agregan al RDN si no se requiere ninguna. En este caso, el valor RDN de salida es el mismo que el valor de RDN de entrada.
Cuando se requiere comillas, el RDN se cita de acuerdo con la especificación "Protocolo ligero de acceso a directorios (v3): Representación de cadena UTF-8 de nombres distintivos", RFC 2253.
Los valores RDN de entrada y salida no son cadenas terminadas en NULL.
Para revertir los cambios realizados por esta llamada, llame a la función DsUnquoteRdnValue .
Nota:
El encabezado dsparse.h define DsQuoteRdnValue 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 Convenciones para prototipos de función.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | dsparse.h (incluya Ntdsapi.h) |
| Library | Ntdsapi.lib |
| Archivo DLL | Ntdsapi.dll |
Consulte también
Funciones de administración de replicación y controlador de dominio