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.
| Return code | Description |
|---|---|
|
Not enough storage is available to process this command. |
Remarks
No special group membership is required to successfully execute the NetGetJoinInformation function.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | lmjoin.h (include Lm.h) |
| Library | Netapi32.lib |
| DLL | Netapi32.dll; Wkscli.dll |