NAME¶

GetServiceA (WSOCK32.1119)

SYNOPSIS¶

INT GetServiceA
(
DWORD dwNameSpace,
LPGUID lpGuid,
LPSTR lpServiceName,
DWORD dwProperties,
LPVOID lpBuffer,
LPDWORD lpdwBufferSize,
LPSERVICE_ASYNC_INFO lpServiceAsyncInfo
)

DESCRIPTION¶

Get information about a network service.

PARAMS¶

dwNameSpace [In] Name space or set of name spaces within which the function. will operate. lpGuid [In] Pointer to GUID of network service type. lpServiceName [In] NUL-terminated ASCII string that uniquely represents the name. of the service. dwProperties [In] Flags specifying which information to return in lpBuffer. lpBuffer [Out] Pointer to buffer where the function returns an array. of NS_SERVICE_INFO. lpdwBufferSize [In/Out] Size of lpBuffer. A greater number on output. indicates an error. lpServiceAsyncInfo [Out] Reserved. Set to NULL.

RETURNS¶

Success: 0. Failure: SOCKET_ERROR. GetLastError(3w) returns ERROR_INSUFFICIENT_BUFFER or ERROR_SERVICE_NOT_FOUND.

NOTES¶

Obsolete Microsoft-specific extension to Winsock 1.1, Protocol-independent name resolution provides equivalent functionality in Winsock 2.

BUGS¶

Unimplemented.

IMPLEMENTATION¶

Declared in "nspapi.h". Implemented in "dlls/wsock32/service.c". Debug channel "winsock".