Funzione FaxConnectFaxServerA (winfax.h)

La funzione FaxConnectFaxServer connette un'applicazione client fax al server fax locale. La funzione restituisce un handle server fax necessario per chiamare altre funzioni client fax che facilitano il processo, il dispositivo, la configurazione e la gestione dei documenti.

Sintassi

WINFAXAPI BOOL FaxConnectFaxServerA(
  [in, optional] LPCSTR   MachineName,
  [out]          LPHANDLE FaxHandle
);

Parametri

[in, optional] MachineName

Tipo: LPCTSTR

Questo puntatore deve essere NULL (stringa vuota), in modo che l'applicazione si connetta al server fax nel computer locale.

[out] FaxHandle

Tipo: LPHANDLE

Puntatore a una variabile che riceve un handle server fax necessario per le chiamate successive ad altre funzioni client fax. Se il server fax restituisce un handle Null, indica un errore.

Valore restituito

Tipo: bool

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError. GetLastError può restituire uno degli errori seguenti.

Codice restituito	Descrizione
ERROR_INVALID_PARAMETER	Il parametro FaxHandle è NULL.
ERROR_NOT_ENOUGH_MEMORY	Si è verificato un errore durante l'allocazione della memoria.
ERROR_ACCESS_DENIED	L'utente con il cui account è stata effettuata la chiamata non dispone di diritti sufficienti per il server fax.

Osservazioni

Questa funzione può essere usata solo con un server locale. L'uso di un server remoto è abilitato nell'API COM estesa del servizio fax . Per altre informazioni, vedere il metodo IFaxServer::Connect.

Un'applicazione client fax deve chiamare correttamente la funzione FaxConnectFaxServer prima di chiamare qualsiasi altra funzione client fax.

L'applicazione client fax deve chiamare la funzione FaxClose per disconnettersi dal server fax e deallocare l'handle restituito dalla funzione FaxConnectFaxServer. Per altre informazioni, vedere Connessione al server fax e disconnessione da un server fax.

Nota

L'intestazione winfax.h definisce FaxConnectFaxServer come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winfax.h
libreria	WinFax.lib

Vedere anche

funzioni API client del servizio fax

API client servizio fax per Windows 2000

FaxClose