[NETAPI32] Add annotations and move NetUseGetInfo to a better location.

This commit is contained in:
Eric Kohl 2018-08-05 15:36:48 +02:00
parent 0a5ccac599
commit 89f6e701d4

View file

@ -244,23 +244,23 @@ NetEnumerateComputerNames(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetGetJoinInformation( NetGetJoinInformation(
LPCWSTR Server, _In_ LPCWSTR lpServer,
LPWSTR *Name, _Out_ LPWSTR *lpNameBuffer,
PNETSETUP_JOIN_STATUS type) _Out_ PNETSETUP_JOIN_STATUS BufferType)
{ {
NET_API_STATUS status; NET_API_STATUS status;
TRACE("NetGetJoinInformation(%s %p %p)\n", debugstr_w(Server), TRACE("NetGetJoinInformation(%s %p %p)\n",
Name, type); debugstr_w(lpServer), lpNameBuffer, BufferType);
if (Name == NULL || type == NULL) if (lpNameBuffer == NULL || BufferType == NULL)
return ERROR_INVALID_PARAMETER; return ERROR_INVALID_PARAMETER;
RpcTryExcept RpcTryExcept
{ {
status = NetrGetJoinInformation((LPWSTR)Server, status = NetrGetJoinInformation((LPWSTR)lpServer,
Name, lpNameBuffer,
type); BufferType);
} }
RpcExcept(EXCEPTION_EXECUTE_HANDLER) RpcExcept(EXCEPTION_EXECUTE_HANDLER)
{ {
@ -518,10 +518,10 @@ NetUnjoinDomain(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetUseAdd( NetUseAdd(
LMSTR UncServerName, _In_ LMSTR UncServerName,
DWORD Level, _In_ DWORD Level,
LPBYTE Buf, _In_ LPBYTE Buf,
LPDWORD ParmError) _Out_ LPDWORD ParmError)
{ {
NET_API_STATUS status; NET_API_STATUS status;
@ -548,9 +548,9 @@ NetUseAdd(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetUseDel( NetUseDel(
LMSTR UncServerName, _In_ LMSTR UncServerName,
LMSTR UseName, _In_ LMSTR UseName,
DWORD ForceCond) _In_ DWORD ForceCond)
{ {
NET_API_STATUS status; NET_API_STATUS status;
@ -576,13 +576,13 @@ NetUseDel(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetUseEnum( NetUseEnum(
LMSTR UncServerName, _In_ LMSTR UncServerName,
DWORD Level, _In_ DWORD Level,
LPBYTE *BufPtr, _Out_ LPBYTE *BufPtr,
DWORD PreferedMaximumSize, _In_ DWORD PreferedMaximumSize,
LPDWORD EntriesRead, _Out_ LPDWORD EntriesRead,
LPDWORD TotalEntries, _Out_ LPDWORD TotalEntries,
LPDWORD ResumeHandle) _Inout_ LPDWORD ResumeHandle)
{ {
USE_ENUM_STRUCT UseEnumInfo; USE_ENUM_STRUCT UseEnumInfo;
USE_INFO_0_CONTAINER Container0; USE_INFO_0_CONTAINER Container0;
@ -656,6 +656,38 @@ NetUseEnum(
} }
NET_API_STATUS
WINAPI
NetUseGetInfo(
_In_ LMSTR UncServerName,
_In_ LMSTR UseName,
_In_ DWORD Level,
_Out_ LPBYTE *BufPtr)
{
NET_API_STATUS status;
TRACE("NetUseGetInfo(%s, %s, %d, %p)\n", debugstr_w(UncServerName),
debugstr_w(UseName), Level, BufPtr);
*BufPtr = NULL;
RpcTryExcept
{
status = NetrUseGetInfo(UncServerName,
UseName,
Level,
(LPUSE_INFO)BufPtr);
}
RpcExcept(EXCEPTION_EXECUTE_HANDLER)
{
status = I_RpcMapWin32Status(RpcExceptionCode());
}
RpcEndExcept;
return status;
}
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetValidateName( NetValidateName(
@ -696,50 +728,18 @@ NetValidateName(
} }
NET_API_STATUS
WINAPI
NetUseGetInfo(
LMSTR UncServerName,
LMSTR UseName,
DWORD Level,
LPBYTE *BufPtr)
{
NET_API_STATUS status;
TRACE("NetUseGetInfo(%s, %s, %d, %p)\n", debugstr_w(UncServerName),
debugstr_w(UseName), Level, BufPtr);
*BufPtr = NULL;
RpcTryExcept
{
status = NetrUseGetInfo(UncServerName,
UseName,
Level,
(LPUSE_INFO)BufPtr);
}
RpcExcept(EXCEPTION_EXECUTE_HANDLER)
{
status = I_RpcMapWin32Status(RpcExceptionCode());
}
RpcEndExcept;
return status;
}
#if 0 #if 0
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetWkstaGetInfo( NetWkstaGetInfo(
LPWSTR servername, _In_ LPWSTR servername,
DWORD level, _In_ DWORD level,
LPBYTE *bufptr) _Out_ LPBYTE *bufptr)
{ {
NET_API_STATUS status; NET_API_STATUS status;
TRACE("NetWkstaGetInfo(%s, %d, %p)\n", debugstr_w(servername), TRACE("NetWkstaGetInfo(%s, %d, %p)\n",
level, bufptr); debugstr_w(servername), level, bufptr);
if (bufptr == NULL) if (bufptr == NULL)
return ERROR_INVALID_PARAMETER; return ERROR_INVALID_PARAMETER;
@ -766,15 +766,15 @@ NetWkstaGetInfo(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetWkstaSetInfo( NetWkstaSetInfo(
LPWSTR servername, _In_ LPWSTR servername,
DWORD level, _In_ DWORD level,
LPBYTE buffer, _In_ LPBYTE buffer,
LPDWORD parm_err) _Out_ LPDWORD parm_err)
{ {
NET_API_STATUS status; NET_API_STATUS status;
TRACE("NetWkstaSetInfo(%s, %d, %p, %p)\n", debugstr_w(servername), TRACE("NetWkstaSetInfo(%s, %d, %p, %p)\n",
level, buffer, parm_err); debugstr_w(servername), level, buffer, parm_err);
RpcTryExcept RpcTryExcept
{ {
@ -796,10 +796,10 @@ NetWkstaSetInfo(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetWkstaTransportAdd( NetWkstaTransportAdd(
LPWSTR servername, _In_opt_ LPWSTR servername,
DWORD level, _In_ DWORD level,
LPBYTE buf, _In_ LPBYTE buf,
LPDWORD parm_err) _Out_ LPDWORD parm_err)
{ {
NET_API_STATUS status; NET_API_STATUS status;
@ -826,9 +826,9 @@ NetWkstaTransportAdd(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetWkstaTransportDel( NetWkstaTransportDel(
LPWSTR servername, _In_opt_ LPWSTR servername,
LPWSTR transportname, _In_ LPWSTR transportname,
DWORD ucond) _In_ DWORD ucond)
{ {
NET_API_STATUS status; NET_API_STATUS status;
@ -855,13 +855,13 @@ NetWkstaTransportDel(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetWkstaTransportEnum( NetWkstaTransportEnum(
LPWSTR servername, _In_opt_ LPWSTR servername,
DWORD level, _In_ DWORD level,
LPBYTE *bufptr, _Out_ LPBYTE *bufptr,
DWORD prefmaxlen, _In_ DWORD prefmaxlen,
LPDWORD entriesread, _Out_ LPDWORD entriesread,
LPDWORD totalentries, _Out_ LPDWORD totalentries,
LPDWORD resumehandle) _Inout_ LPDWORD resumehandle)
{ {
WKSTA_TRANSPORT_ENUM_STRUCT TransportEnumInfo; WKSTA_TRANSPORT_ENUM_STRUCT TransportEnumInfo;
WKSTA_TRANSPORT_INFO_0_CONTAINER Container0; WKSTA_TRANSPORT_INFO_0_CONTAINER Container0;
@ -914,13 +914,13 @@ NetWkstaTransportEnum(
NET_API_STATUS NET_API_STATUS
WINAPI WINAPI
NetWkstaUserEnum( NetWkstaUserEnum(
LPWSTR servername, _In_ LPWSTR servername,
DWORD level, _In_ DWORD level,
LPBYTE *bufptr, _Out_ LPBYTE *bufptr,
DWORD prefmaxlen, _In_ DWORD prefmaxlen,
LPDWORD entriesread, _Out_ LPDWORD entriesread,
LPDWORD totalentries, _Out_ LPDWORD totalentries,
LPDWORD resumehandle) _Inout_ LPDWORD resumehandle)
{ {
WKSTA_USER_ENUM_STRUCT UserEnumInfo; WKSTA_USER_ENUM_STRUCT UserEnumInfo;
WKSTA_USER_INFO_0_CONTAINER Container0; WKSTA_USER_INFO_0_CONTAINER Container0;
@ -986,13 +986,13 @@ NET_API_STATUS
WINAPI WINAPI
NetWkstaUserGetInfo( NetWkstaUserGetInfo(
LPWSTR reserved, LPWSTR reserved,
DWORD level, _In_ DWORD level,
PBYTE *bufptr) _Out_ PBYTE *bufptr)
{ {
NET_API_STATUS status; NET_API_STATUS status;
TRACE("NetWkstaUserGetInfo(%s, %d, %p)\n", debugstr_w(reserved), TRACE("NetWkstaUserGetInfo(%s, %d, %p)\n",
level, bufptr); debugstr_w(reserved), level, bufptr);
if (reserved != NULL) if (reserved != NULL)
return ERROR_INVALID_PARAMETER; return ERROR_INVALID_PARAMETER;
@ -1020,14 +1020,14 @@ NET_API_STATUS
WINAPI WINAPI
NetWkstaUserSetInfo( NetWkstaUserSetInfo(
LPWSTR reserved, LPWSTR reserved,
DWORD level, _In_ DWORD level,
LPBYTE buf, _In_ LPBYTE buf,
LPDWORD parm_err) _Out_ LPDWORD parm_err)
{ {
NET_API_STATUS status; NET_API_STATUS status;
TRACE("NetWkstaSetInfo(%s, %d, %p, %p)\n", debugstr_w(reserved), TRACE("NetWkstaSetInfo(%s, %d, %p, %p)\n",
level, buf, parm_err); debugstr_w(reserved), level, buf, parm_err);
if (reserved != NULL) if (reserved != NULL)
return ERROR_INVALID_PARAMETER; return ERROR_INVALID_PARAMETER;