NetGetJoinInformation function (lmjoin.h)

The NetGetJoinInformation function retrieves join status information for the specified computer.

Syntax

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

Parameters

[in] lpServer

Pointer to a constant string that specifies the DNS or NetBIOS name of the computer on which to call the function. If this parameter is NULL, the local computer is used.

[out] lpNameBuffer

Pointer to the buffer that receives the NetBIOS name of the domain or workgroup to which the computer is joined. This buffer is allocated by the system and must be freed using the NetApiBufferFree function. For more information, see Network Management Function Buffers and Network Management Function Buffer Lengths.

[out] BufferType

Receives the join status of the specified computer. This parameter can have one of the following values.

typedef enum _NETSETUP_JOIN_STATUS {

    NetSetupUnknownStatus = 0,
    NetSetupUnjoined,
    NetSetupWorkgroupName,
    NetSetupDomainName

} NETSETUP_JOIN_STATUS, *PNETSETUP_JOIN_STATUS;

These values have the following meanings.

Return value

If the function succeeds, the return value is NERR_Success.

If the function fails, the return value can be the following error code or one of the system error codes.

Remarks

No special group membership is required to successfully execute the NetGetJoinInformation function.

Requirements

See also

NetGetJoinableOUs

Network Management Functions

Network Management Overview