Función NetGetJoinInformation (lmjoin.h)

  • Artículo

La función NetGetJoinInformation recupera la información de estado de combinación del equipo especificado.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetGetJoinInformation(
  [in]  LPCWSTR               lpServer,
  [out] LPWSTR                *lpNameBuffer,
  [out] PNETSETUP_JOIN_STATUS BufferType
);

Parámetros

[in] lpServer

Puntero a una cadena constante que especifica el nombre DNS o NetBIOS del equipo en el que se va a llamar a la función. Si este parámetro es NULL, se usa el equipo local.

[out] lpNameBuffer

Puntero al búfer que recibe el nombre NetBIOS del dominio o grupo de trabajo al que está unido el equipo. El sistema asigna este búfer y se debe liberar mediante la función NetApiBufferFree . Para obtener más información, consulte Network Management Function Buffers (Búferes de funciones de administración de red) y Network Management Function Buffer Lengths (Longitudes de búfer de funciones de administración de red).

[out] BufferType

Recibe el estado de combinación del equipo especificado. Este parámetro puede tener uno de los valores siguientes.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

Estos valores tienen los significados siguientes.

Valor Significado
NetSetupUnknownStatus
 El estado es desconocido.
NetSetupUnjoined
 El equipo no está unido.
NetSetupWorkgroupName
 El equipo está unido a un grupo de trabajo.
NetSetupDomainName
 El equipo está unido a un dominio.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser el siguiente código de error o uno de los códigos de error del sistema.

Código devuelto Descripción
ERROR_NOT_ENOUGH_MEMORY
 No hay suficiente almacenamiento disponible para procesar este comando.

Comentarios

No se requiere ninguna pertenencia especial a grupos para ejecutar correctamente la función NetGetJoinInformation .

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado lmjoin.h (include Lm.h)
Library Netapi32.lib
Archivo DLL Netapi32.dll; Wkscli.dll

Consulte también

NetGetJoinableOUs

Funciones de administración de redes

Introducción a la administración de redes