netapi32.h File Reference

#include <wine/config.h>
#include <limits.h>
#include <stdarg.h>
#include <windef.h>
#include <winbase.h>
#include <lmaccess.h>
#include <lmapibuf.h>
#include <lmerr.h>
#include <ntsecapi.h>
#include <nb30.h>
#include <iphlpapi.h>
#include <wine/debug.h>
#include <wine/unicode.h>
#include <ndk/rtlfuncs.h>
#include <ntsam.h>
#include "nbnamecache.h"
#include "netbios.h"

Include dependency graph for netapi32.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	WIN32_NO_STATUS
#define	_INC_WINDOWS
#define	COM_NO_WINDOWS_H
#define	NTOS_MODE_USER

Functions
NTSTATUS	GetAccountDomainSid (IN PUNICODE_STRING ServerName, OUT PSID *AccountDomainSid)
NTSTATUS	GetBuiltinDomainSid (OUT PSID *BuiltinDomainSid)
NTSTATUS	OpenAccountDomain (IN SAM_HANDLE ServerHandle, IN PUNICODE_STRING ServerName, IN ULONG DesiredAccess, OUT PSAM_HANDLE DomainHandle)
NTSTATUS	OpenBuiltinDomain (IN SAM_HANDLE ServerHandle, IN ULONG DesiredAccess, OUT SAM_HANDLE *DomainHandle)
NET_API_STATUS	BuildSidFromSidAndRid (IN PSID SrcSid, IN ULONG RelativeId, OUT PSID *DestSid)
VOID	CopySidFromSidAndRid (_Out_ PSID DstSid, _In_ PSID SrcSid, _In_ ULONG RelativeId)
PSTR WINAPI	NetpAllocAnsiStrFromWStr (_In_ PWSTR InString)
PSTR WINAPI	NetpAllocStrFromWStr (_In_ PWSTR InString)
PWSTR WINAPI	NetpAllocWStrFromAnsiStr (_In_ PSTR InString)
PWSTR WINAPI	NetpAllocWStrFromStr (_In_ PSTR InString)
PWSTR WINAPI	NetpAllocWStrFromWStr (_In_ PWSTR InString)
NET_API_STATUS WINAPI	NetpNtStatusToApiStatus (_In_ NTSTATUS Status)
BOOL	NETAPI_IsLocalComputer (LMCSTR ServerName)

Variables
LIST_ENTRY	g_EnumContextListHead
CRITICAL_SECTION	g_EnumContextListLock

Macro Definition Documentation

_INC_WINDOWS

#define _INC_WINDOWS

Definition at line 10 of file netapi32.h.

COM_NO_WINDOWS_H

#define COM_NO_WINDOWS_H

Definition at line 11 of file netapi32.h.

NTOS_MODE_USER

#define NTOS_MODE_USER

Definition at line 25 of file netapi32.h.

WIN32_NO_STATUS

#define WIN32_NO_STATUS

Definition at line 9 of file netapi32.h.

Function Documentation

BuildSidFromSidAndRid()

NET_API_STATUS BuildSidFromSidAndRid	(	IN PSID	SrcSid,
		IN ULONG	RelativeId,
		OUT PSID *	DestSid
	)

Definition at line 177 of file utils.c.

{
    UCHAR RidCount;
    PSID DstSid;
    ULONG i;
    ULONG DstSidSize;
    PULONG p, q;
    NET_API_STATUS ApiStatus = NERR_Success;

    RidCount = *RtlSubAuthorityCountSid(SrcSid);
    if (RidCount >= 8)
        return ERROR_INVALID_PARAMETER;

    DstSidSize = RtlLengthRequiredSid(RidCount + 1);

    ApiStatus = NetApiBufferAllocate(DstSidSize,
                                     &DstSid);
    if (ApiStatus != NERR_Success)
        return ApiStatus;

    RtlInitializeSid(DstSid,
                     RtlIdentifierAuthoritySid(SrcSid),
                     RidCount + 1);

    for (i = 0; i < (ULONG)RidCount; i++)
    {
        p = RtlSubAuthoritySid(SrcSid, i);
        q = RtlSubAuthoritySid(DstSid, i);
        *q = *p;
    }

    q = RtlSubAuthoritySid(DstSid, (ULONG)RidCount);
    *q = RelativeId;

    *DestSid = DstSid;

    return NERR_Success;
}

Referenced by BuildSidListFromDomainAndName(), GetUserPrivileges(), and NetUserGetLocalGroups().

CopySidFromSidAndRid()

VOID CopySidFromSidAndRid	(	_Out_ PSID	DstSid,
		_In_ PSID	SrcSid,
		_In_ ULONG	RelativeId
	)

Definition at line 220 of file utils.c.

{
    UCHAR RidCount;
    ULONG i;
    PULONG p, q;

    RidCount = *RtlSubAuthorityCountSid(SrcSid);
    if (RidCount >= 8)
        return;

    RtlInitializeSid(DstSid,
                     RtlIdentifierAuthoritySid(SrcSid),
                     RidCount + 1);

    for (i = 0; i < (ULONG)RidCount; i++)
    {
        p = RtlSubAuthoritySid(SrcSid, i);
        q = RtlSubAuthoritySid(DstSid, i);
        *q = *p;
    }

    q = RtlSubAuthoritySid(DstSid, (ULONG)RidCount);
    *q = RelativeId;
}

Referenced by BuildUserInfoBuffer().

GetAccountDomainSid()

NTSTATUS GetAccountDomainSid	(	IN PUNICODE_STRING	ServerName,
		OUT PSID *	AccountDomainSid
	)

Definition at line 23 of file utils.c.

{
    PPOLICY_ACCOUNT_DOMAIN_INFO AccountDomainInfo = NULL;
    LSA_OBJECT_ATTRIBUTES ObjectAttributes;
    LSA_HANDLE PolicyHandle = NULL;
    ULONG Length = 0;
    NTSTATUS Status;

    memset(&ObjectAttributes, 0, sizeof(LSA_OBJECT_ATTRIBUTES));

    Status = LsaOpenPolicy(ServerName,
                           &ObjectAttributes,
                           POLICY_VIEW_LOCAL_INFORMATION,
                           &PolicyHandle);
    if (!NT_SUCCESS(Status))
    {
        ERR("LsaOpenPolicy failed (Status %08lx)\n", Status);
        return Status;
    }

    Status = LsaQueryInformationPolicy(PolicyHandle,
                                       PolicyAccountDomainInformation,
                                       (PVOID *)&AccountDomainInfo);
    if (!NT_SUCCESS(Status))
    {
        ERR("LsaQueryInformationPolicy failed (Status %08lx)\n", Status);
        goto done;
    }

    Length = RtlLengthSid(AccountDomainInfo->DomainSid);

    *AccountDomainSid = RtlAllocateHeap(RtlGetProcessHeap(), 0, Length);
    if (*AccountDomainSid == NULL)
    {
        ERR("Failed to allocate SID\n");
        Status = STATUS_INSUFFICIENT_RESOURCES;
        goto done;
    }

    memcpy(*AccountDomainSid, AccountDomainInfo->DomainSid, Length);

done:
    if (AccountDomainInfo != NULL)
        LsaFreeMemory(AccountDomainInfo);

    LsaClose(PolicyHandle);

    return Status;
}

Referenced by OpenAccountDomain().

GetBuiltinDomainSid()

NTSTATUS GetBuiltinDomainSid

(

OUT PSID *

BuiltinDomainSid

)

Definition at line 76 of file utils.c.

{
    PSID Sid = NULL;
    PULONG Ptr;
    NTSTATUS Status = STATUS_SUCCESS;

    *BuiltinDomainSid = NULL;

    Sid = RtlAllocateHeap(RtlGetProcessHeap(),
                          0,
                          RtlLengthRequiredSid(1));
    if (Sid == NULL)
        return STATUS_INSUFFICIENT_RESOURCES;

    Status = RtlInitializeSid(Sid,
                              &NtAuthority,
                              1);
    if (!NT_SUCCESS(Status))
        goto done;

    Ptr = RtlSubAuthoritySid(Sid, 0);
    *Ptr = SECURITY_BUILTIN_DOMAIN_RID;

    *BuiltinDomainSid = Sid;

done:
    if (!NT_SUCCESS(Status))
    {
        if (Sid != NULL)
            RtlFreeHeap(RtlGetProcessHeap(), 0, Sid);
    }

    return Status;
}

Referenced by NetUserEnum(), NetUserGetInfo(), and OpenBuiltinDomain().

NETAPI_IsLocalComputer()

BOOL NETAPI_IsLocalComputer

(

LMCSTR

ServerName

)

Definition at line 33 of file wksta.c.

{
    WCHAR buf[MAX_COMPUTERNAME_LENGTH + 1];
    DWORD size = sizeof(buf) / sizeof(buf[0]);
    BOOL ret;

    if (!name || !name[0]) return TRUE;

    ret = GetComputerNameW( buf,  &size );
    if (ret && name[0] == '\\' && name[1] == '\\') name += 2;
    return ret && !strcmpiW( name, buf );
}

Referenced by NetWkstaTransportEnum().

NetpAllocAnsiStrFromWStr()

PSTR WINAPI NetpAllocAnsiStrFromWStr

(

_In_ PWSTR

InString

)

Definition at line 140 of file misc.c.

{
    UNICODE_STRING UnicodeString;
    ANSI_STRING AnsiString;
    ULONG Size;
    NET_API_STATUS NetStatus;
    NTSTATUS Status;

    RtlInitUnicodeString(&UnicodeString, InString);

    Size = RtlUnicodeStringToAnsiSize(&UnicodeString);
    NetStatus = NetApiBufferAllocate(Size,
                                     (PVOID*)&AnsiString.Buffer);
    if (NetStatus != NERR_Success)
        return NULL;

    Status = RtlUnicodeStringToAnsiString(&AnsiString,
                                          &UnicodeString,
                                          FALSE);
    if (!NT_SUCCESS(Status))
    {
        NetApiBufferFree(AnsiString.Buffer);
        return NULL;
    }

    return AnsiString.Buffer;
}

Referenced by DsGetSiteNameA().

NetpAllocStrFromWStr()

PSTR WINAPI NetpAllocStrFromWStr

(

_In_ PWSTR

InString

)

Definition at line 172 of file misc.c.

{
    UNICODE_STRING UnicodeString;
    OEM_STRING OemString;
    ULONG Size;
    NET_API_STATUS NetStatus;
    NTSTATUS Status;

    RtlInitUnicodeString(&UnicodeString, InString);

    Size = RtlUnicodeStringToOemSize(&UnicodeString);
    NetStatus = NetApiBufferAllocate(Size,
                                     (PVOID*)&OemString.Buffer);
    if (NetStatus != NERR_Success)
        return NULL;

    Status = RtlUnicodeStringToOemString(&OemString,
                                         &UnicodeString,
                                         FALSE);
    if (!NT_SUCCESS(Status))
    {
        NetApiBufferFree(OemString.Buffer);
        return NULL;
    }

    return OemString.Buffer;
}

NetpAllocWStrFromAnsiStr()

PWSTR WINAPI NetpAllocWStrFromAnsiStr

(

_In_ PSTR

InString

)

Definition at line 204 of file misc.c.

{
    ANSI_STRING AnsiString;
    UNICODE_STRING UnicodeString;
    ULONG Size;
    NET_API_STATUS NetStatus;
    NTSTATUS Status;

    RtlInitAnsiString(&AnsiString, InString);

    Size = RtlAnsiStringToUnicodeSize(&AnsiString);
    NetStatus = NetApiBufferAllocate(Size,
                                     (PVOID*)&UnicodeString.Buffer);
    if (NetStatus != NERR_Success)
        return NULL;

    Status = RtlAnsiStringToUnicodeString(&UnicodeString,
                                          &AnsiString,
                                          FALSE);
    if (!NT_SUCCESS(Status))
    {
        NetApiBufferFree(UnicodeString.Buffer);
        return NULL;
    }

    return UnicodeString.Buffer;
}

Referenced by DsAddressToSiteNamesA(), DsAddressToSiteNamesExA(), DsDeregisterDnsHostRecordsA(), DsEnumerateDomainTrustsA(), DsGetDcNameWithAccountA(), DsGetDcSiteCoverageA(), and DsGetSiteNameA().

NetpAllocWStrFromStr()

PWSTR WINAPI NetpAllocWStrFromStr

(

_In_ PSTR

InString

)

Definition at line 236 of file misc.c.

{
    OEM_STRING OemString;
    UNICODE_STRING UnicodeString;
    ULONG Size;
    NET_API_STATUS NetStatus;
    NTSTATUS Status;

    RtlInitAnsiString((PANSI_STRING)&OemString, InString);

    Size = RtlOemStringToUnicodeSize(&OemString);
    NetStatus = NetApiBufferAllocate(Size,
                                     (PVOID*)&UnicodeString.Buffer);
    if (NetStatus != NERR_Success)
        return NULL;

    Status = RtlOemStringToUnicodeString(&UnicodeString,
                                         &OemString,
                                         FALSE);
    if (!NT_SUCCESS(Status))
    {
        NetApiBufferFree(UnicodeString.Buffer);
        return NULL;
    }

    return UnicodeString.Buffer;
}

NetpAllocWStrFromWStr()

PWSTR WINAPI NetpAllocWStrFromWStr

(

_In_ PWSTR

InString

)

Definition at line 268 of file misc.c.

{
    PWSTR OutString;
    ULONG Size;
    NET_API_STATUS Status;

    Size = (wcslen(InString) + 1) * sizeof(WCHAR);
    Status = NetApiBufferAllocate(Size,
                                  (PVOID*)&OutString);
    if (Status != NERR_Success)
        return NULL;

    wcscpy(OutString, InString);

    return OutString;
}

NetpNtStatusToApiStatus()

NET_API_STATUS WINAPI NetpNtStatusToApiStatus

(

_In_ NTSTATUS

Status

)

Definition at line 289 of file misc.c.

{
    NET_API_STATUS ApiStatus;

    switch (Status)
    {
        case STATUS_SUCCESS:
            ApiStatus = NERR_Success;
            break;

        case STATUS_INVALID_ACCOUNT_NAME:
            ApiStatus = NERR_BadUsername;
            break;

        case STATUS_USER_EXISTS:
            ApiStatus = NERR_UserExists;
            break;

        case STATUS_GROUP_EXISTS:
            ApiStatus = NERR_GroupExists;
            break;

        case STATUS_PASSWORD_RESTRICTION:
            ApiStatus = NERR_PasswordTooShort;
            break;

        default:
            ApiStatus = RtlNtStatusToDosError(Status);
            break;
    }

    return ApiStatus;
}

Referenced by BuildSidListFromDomainAndName(), BuildUserInfoBuffer(), GetUserDacl(), GetUserPrivileges(), NetGetDisplayInformationIndex(), NetGroupAdd(), NetGroupAddUser(), NetGroupDel(), NetGroupDelUser(), NetGroupEnum(), NetGroupGetInfo(), NetGroupGetUsers(), NetGroupSetInfo(), NetGroupSetUsers(), NetLocalGroupAdd(), NetLocalGroupAddMembers(), NetLocalGroupDel(), NetLocalGroupDelMembers(), NetLocalGroupEnum(), NetLocalGroupGetInfo(), NetLocalGroupGetMembers(), NetLocalGroupSetInfo(), NetpBind(), NetpUnbind(), NetQueryDisplayInformation(), NetRegisterDomainNameChangeNotification(), NetUnregisterDomainNameChangeNotification(), NetUserAdd(), NetUserChangePassword(), NetUserDel(), NetUserEnum(), NetUserGetGroups(), NetUserGetInfo(), NetUserGetLocalGroups(), NetUserModalsGet(), NetUserSetInfo(), OpenAliasByName(), OpenGroupByName(), OpenUserByName(), and SetUserInfo().

OpenAccountDomain()

NTSTATUS OpenAccountDomain	(	IN SAM_HANDLE	ServerHandle,
		IN PUNICODE_STRING	ServerName,
		IN ULONG	DesiredAccess,
		OUT PSAM_HANDLE	DomainHandle
	)

Definition at line 113 of file utils.c.

{
    PSID DomainSid = NULL;
    NTSTATUS Status;

    Status = GetAccountDomainSid(ServerName,
                                 &DomainSid);
    if (!NT_SUCCESS(Status))
    {
        ERR("GetAccountDomainSid failed (Status %08lx)\n", Status);
        return Status;
    }

    Status = SamOpenDomain(ServerHandle,
                           DesiredAccess,
                           DomainSid,
                           DomainHandle);

    RtlFreeHeap(RtlGetProcessHeap(), 0, DomainSid);

    if (!NT_SUCCESS(Status))
    {
        ERR("SamOpenDomain failed (Status %08lx)\n", Status);
    }

    return Status;
}

Referenced by NetGetDisplayInformationIndex(), NetGroupAdd(), NetGroupAddUser(), NetGroupDel(), NetGroupDelUser(), NetGroupEnum(), NetGroupGetInfo(), NetGroupGetUsers(), NetGroupSetInfo(), NetGroupSetUsers(), NetLocalGroupAdd(), NetLocalGroupAddMembers(), NetLocalGroupDel(), NetLocalGroupDelMembers(), NetLocalGroupEnum(), NetLocalGroupGetInfo(), NetLocalGroupGetMembers(), NetLocalGroupSetInfo(), NetQueryDisplayInformation(), NetUserAdd(), NetUserDel(), and NetUserSetInfo().

OpenBuiltinDomain()

NTSTATUS OpenBuiltinDomain	(	IN SAM_HANDLE	ServerHandle,
		IN ULONG	DesiredAccess,
		OUT SAM_HANDLE *	DomainHandle
	)

Referenced by NetGroupEnum(), NetLocalGroupAdd(), NetLocalGroupAddMembers(), NetLocalGroupDel(), NetLocalGroupDelMembers(), NetLocalGroupEnum(), NetLocalGroupGetInfo(), NetLocalGroupGetMembers(), NetLocalGroupSetInfo(), NetUserDel(), and NetUserGetLocalGroups().

Variable Documentation

g_EnumContextListHead

LIST_ENTRY g_EnumContextListHead

Definition at line 56 of file user.c.

Referenced by AllocateEnumContext(), DllMain(), and LookupEnumContext().

g_EnumContextListLock

CRITICAL_SECTION g_EnumContextListLock

Definition at line 57 of file user.c.

Referenced by AllocateEnumContext(), DllMain(), FreeEnumContext(), and LookupEnumContext().