Considerazioni su Windows CPI-C

Le chiamate e le estensioni di Windows (Common Programming Interface for Communications) (CPI-C) seguenti sono di particolare importanza. È consigliabile esaminarli prima di usare Host Integration Server.

Set_Processing_Mode( cmspm)
Specifica per la conversazione se le chiamate successive vengono restituite quando l'operazione richiesta è completa (blocco) o immediatamente dopo l'avvio dell'operazione (senza blocco). Un programma riceve una notifica del completamento di chiamate non bloccanti quando emette Wait_For_Conversation o tramite un messaggio di Windows inviato a un WndProc identificato da hwndNotify in Specify_Windows_Handle. Quando la modalità di elaborazione è impostata per una conversazione, si applica a tutte le chiamate successive nella conversazione fino a quando la modalità non viene nuovamente impostata.

Specify_Windows_Handle( xchwnd)
Imposta l'handle di finestra su cui viene inviato un messaggio al completamento di un'operazione in modalità non bloccante.

Wait_For_Conversation( cmwait)
Attende il completamento di un'operazione avviata quando la caratteristica della conversazione in modalità di elaborazione è stata impostata su CM_NON_BLOCKING e CM_OPERATION_INCOMPLETE è stata restituita nel parametro return_code . Usare Wait_For_Conversation quando si esegue un thread in background o un'applicazione a thread singolo per Microsoft Windows. Ciò si verifica più probabilmente quando si esegue la conversione di codice da versioni precedenti di Host Integration Server e SNA Server.

Al termine di un'operazione asincrona, la finestra delle applicazioni hwndNotify riceve il messaggio restituito da RegisterWindowMessage con "WinAsyncCPIC" come stringa di input. Il valore wParam contiene il codice restituito della conversazione dall'operazione che viene completata. I relativi valori dipendono dall'operazione originariamente rilasciata. L'argomento lParam contiene il CM_PTR all'identificatore di conversazione specificato nella chiamata di funzione originale.

WinCPICCleanup
Termina e annulla la registrazione di un'applicazione da un'implementazione di Windows CPI-C.

WinCPICExtractEvent
Fornisce un metodo per un'applicazione per determinare l'handle di eventi utilizzato per una conversazione CPI-C.

WinCPICIsBlocking
Determina se un'attività è in esecuzione durante l'attesa del completamento di una chiamata di blocco precedente. Questo è stato usato quando Windows versione 3. x è andato in un PeekMessageLoop , consentendo a Windows di continuare. Anche se una chiamata eseguita su una funzione di blocco sembra essere bloccata da un'applicazione, windows CPI-C libreria a collegamento dinamico (DLL) deve rinunciare al processore per consentire l'esecuzione di altre applicazioni. Ciò significa che è possibile che l'applicazione che ha emesso la chiamata di blocco venga nuovamente immessa, a seconda dei messaggi ricevuti. In questo caso, WinCPICIsBlocking può essere usato per determinare se l'attività dell'applicazione è stata nuovamente immessa durante l'attesa del completamento di una chiamata di blocco in sospeso.

Questa estensione è progettata per fornire assistenza a un'applicazione scritta per usare la caratteristica CM_BLOCKING della funzione windows Specify_Processing_Mode . WinCPICIsBlocking ha lo stesso scopo di InSendMessage nell'API Di Windows.

Applicazioni meno recenti destinate originariamente a Windows versione 3. x e che supportano più conversazioni devono specificare CM_NONBLOCKING in Specify_Processing_Mode in modo che possano supportare più operazioni in sospeso contemporaneamente. Le applicazioni sono ancora limitate a un'operazione in sospeso per conversazione in tutti gli ambienti.

WinCPICSetBlockingHook
Consente a un'implementazione di Windows CPI-C di bloccare CPI-C chiamate di funzione tramite una nuova funzione. Le chiamate di blocco si applicano solo se non si usano chiamate asincrone. Se una funzione deve bloccarsi, la chiamata di blocco viene chiamata ripetutamente fino al completamento della richiesta originale. Ciò consente a Windows di continuare l'esecuzione mentre l'applicazione originale attende che venga restituita la chiamata. Si noti che, all'interno della chiamata di blocco, l'applicazione può essere nuovamente immessa. WinCPICSetBlockingHook è stato usato da Windows versione 3. x applicazioni che sono andate in un PeekMessageLoop per effettuare chiamate di blocco senza bloccare il resto del sistema.

WinCPICSetEvent
Associa un handle di evento Win32 al completamento di un verbo.

WinCPICStartup
Consente a un'applicazione di specificare la versione di Windows CPI-C necessaria e di recuperare i dettagli dell'implementazione CPI-C specifica.

WinCPICUnhookBlockingHook
Rimuove qualsiasi hook di blocco precedente installato e reinstalla il meccanismo di blocco predefinito.