GetServiceA3w
Usage
INT GetServiceA
(
DWORD dwNameSpace,
LPGUID lpGuid,
LPSTR lpServiceName,
DWORD dwProperties,
LPVOID lpBuffer,
LPDWORD lpdwBufferSize,
LPSERVICE_ASYNC_INFO lpServiceAsyncInfo
)
Overview
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.
Implementation
Declared in "nspapi.h".
Implemented in "dlls/wsock32/service.c".
Debug channel "winsock".
Releases
4 releases since Debian 4.0 (Etch); the text changed 3 times.