.\" -*- nroff -*-
.\" Generated file - DO NOT EDIT!
.TH GetServiceA 3w "Oct 2012" "Wine API" "Wine API"

.SH NAME
\fBGetServiceA\fR (WSOCK32.1119)
.SH SYNOPSIS
INT GetServiceA
 (
  DWORD                \fIdwNameSpace\fR,
  LPGUID               \fIlpGuid\fR,
  LPSTR                \fIlpServiceName\fR,
  DWORD                \fIdwProperties\fR,
  LPVOID               \fIlpBuffer\fR,
  LPDWORD              \fIlpdwBufferSize\fR,
  LPSERVICE_ASYNC_INFO \fIlpServiceAsyncInfo\fR
 )

.SH DESCRIPTION
.PP
Get information about a network service. 

.SH PARAMS
\fIdwNameSpace\fR \fB[In]\fR  Name space or set of name spaces within which the function.
.PP
will operate.
.PP
\fIlpGuid\fR \fB[In]\fR  Pointer to \fBGUID\fR of network service type.
.PP
\fIlpServiceName\fR \fB[In]\fR  NUL-terminated \fBASCII\fR string that uniquely represents the name.
.PP
of the service.
.PP
\fIdwProperties\fR \fB[In]\fR  Flags specifying which information to return in \fIlpBuffer\fR.
.PP
\fIlpBuffer\fR \fB[Out]\fR  Pointer to buffer where the function returns an array.
.PP
of \fBNS_SERVICE_INFO\fR.
.PP
\fIlpdwBufferSize\fR \fB[In/Out]\fR  Size of \fIlpBuffer\fR. A greater number on output.
.PP
indicates an error.
.PP
\fIlpServiceAsyncInfo\fR \fB[Out]\fR  Reserved. Set to \fBNULL\fR.
.PP

.SH RETURNS
.PP
\fBSuccess:\fR \fB0.\fR 
.PP
\fBFailure:\fR \fBSOCKET_ERROR\fR. \fBGetLastError(3w)\fR returns \fBERROR_INSUFFICIENT_BUFFER\fR or \fBERROR_SERVICE_NOT_FOUND\fR. 

.SH NOTES
.PP
Obsolete Microsoft-specific extension to Winsock \fB1.1\fR, Protocol-independent name resolution provides equivalent functionality in Winsock \fB2.\fR 

.SH BUGS
.PP
Unimplemented. 

.SH IMPLEMENTATION
.PP
Declared in \fB"nspapi.h"\fR. 
.PP
Implemented in \fB"dlls/wsock32/service.c"\fR. 
.PP
Debug channel \fB"winsock"\fR.