Función DsClientMakeSpnForTargetServerA (ntdsapi.h)

La función DsClientMakeSpnForTargetServer crea 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 define 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 formato estándar de Internet.

No se recomienda usar 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 a través de la resolución de nombres DNS. Es posible que la resolución de nombres DNS se suplanta, reemplazando el nombre de equipo previsto por un nombre de equipo no autorizado.

[in, out] pcSpnLength

Puntero a un valor de DWORD que, en la entrada, contiene el tamaño del búfer de pszSpn, en caracteres. En la salida, este parámetro recibe el número de caracteres copiados en el búfer de pszSpn, incluida la terminación NULL.

[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.

Observaciones

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. El 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 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 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	ntdsapi.h
biblioteca de	Ntdsapi.lib
DLL de	Ntdsapi.dll

Consulte también

controlador de dominio y funciones de administración de replicación

DsMakeSpn