Función DsClientMakeSpnForTargetServerA (ntdsapi.h)
La función DsClientMakeSpnForTargetServer construye un nombre de entidad de seguridad de servicio (SPN) que identifica un servidor específico que se va a usar para la autenticación.
Sintaxis
NTDSAPI DWORD DsClientMakeSpnForTargetServerA(
[in] LPCSTR ServiceClass,
[in] LPCSTR ServiceName,
[in, out] DWORD *pcSpnLength,
[out] LPSTR pszSpn
);
Parámetros
[in] ServiceClass
Puntero a una cadena terminada en null que contiene la clase del servicio tal y como se define en el servicio. Puede ser cualquier cadena única para el servicio.
[in] ServiceName
Puntero a una cadena terminada en null que contiene el nombre de host del servicio de nombres distintivos (DNS). Puede ser un nombre completo o una dirección IP en el formato estándar de Internet.
No se recomienda el uso de una dirección IP para ServiceName porque esto puede crear un problema de seguridad. Antes de construir el SPN, la dirección IP debe traducirse a un nombre de equipo mediante la resolución de nombres DNS. Es posible que la resolución de nombres DNS sea suplantada, reemplazando el nombre de equipo previsto por un nombre de equipo no autorizado.
[in, out] pcSpnLength
Puntero a un valor DWORD que, en la entrada, contiene el tamaño del búfer pszSpn , en caracteres. En la salida, este parámetro recibe el número de caracteres copiados en el búfer pszSpn , incluido el valor NULL de terminación.
[out] pszSpn
Puntero a un búfer de cadena que recibe el SPN.
Valor devuelto
Esta función devuelve códigos de error estándar de Windows.
Comentarios
Al usar esta función, proporcione la clase de servicio y parte de un nombre de host DNS.
Esta función es una versión simplificada de la función DsMakeSpn . ServiceName se convierte en canónico resolviendo a través de DNS.
No se admiten nombres DNS basados en GUID. Cuando se construye, el SPN simplificado es el siguiente:
ServiceClass / ServiceName / ServiceName
La parte del nombre de instancia (segunda posición) siempre se establece en el valor predeterminado. No se usan los campos de puerto y de referencia.
Nota
El encabezado ntdsapi.h define DsClientMakeSpnForTargetServer 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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | ntdsapi.h |
| Library | Ntdsapi.lib |
| Archivo DLL | Ntdsapi.dll |
Consulte también
Funciones de administración de replicación y controlador de dominio