WinAPPCStartup

WinAPPCStartup 関数を使用すると、アプリケーションで必要な Windows APPC のバージョンを指定し、特定の Windows APPC 実装の詳細を取得できます。 アプリケーションは、それ以上の Windows APPC 呼び出しを発行する前に、この関数を呼び出して Windows APPC 実装に登録する必要があります。

構文

  
            int WINAPI WinAPPCStartup(   
        WORDwVersionRequired,  
        LPWAPPCDATAlpAPPCData  
);  
  
typedef struct {  
    WORD wVersion;  
    char szDescription[WAPPCDESCRIPTION_LEN+1];  
} WAPPCDATA, FAR * LPWAPPCDATA;  
  
where WAPPCDESCRIPTION_LEN is defined as 127  

パラメーター

wVersionRequired
必要な Windows APPC サポートのバージョンを指定します。 上位バイトはマイナー バージョン (リビジョン) 番号を指定します。下位バイトはメジャー バージョン番号を指定します。 Windows APPC API の現在のバージョンは 1.0 です。

lpAPPCData
Windows APPC のバージョン番号と Windows APPC 実装の説明を含む、返される構造体へのポインター。

戻り値

戻り値は、アプリケーションが正常に登録されたかどうか、および Windows APPC 実装で指定されたバージョン番号をサポートできるかどうかを指定します。 値が 0 の場合は、正常に登録され、指定されたバージョンをサポートできます。 それ以外の場合、戻り値は次のいずれかになります。

WAPPCSYSNOTREADY
基になるネットワーク システムは、ネットワーク通信の準備ができていません。

WAPPCVERNOTSUPPORTED
要求された Windows APPC サポートのバージョンは、この特定の Windows APPC 実装では提供されません。

WAPPCINVALID
アプリケーションで指定された Windows APPC バージョンは、この DLL ではサポートされていません。

注釈

Windows APPC バージョン 1.0 と機能の違いがある可能性のある将来の Windows APPC の実装とアプリケーションをサポートするために、 WinAPPCStartup でネゴシエーションが行われます。 アプリケーションは 、使用できる Windows APPC バージョンを WinAPPCStartup に渡します。 このバージョンが Windows APPC DLL でサポートされている最低バージョンより低い場合、DLL はアプリケーションをサポートできず、 WinAPPCStartup は失敗します。 ただし、バージョンが低くない場合、呼び出しは成功し、DLL でサポートされている最高バージョンの Windows APPC を返します。 このバージョンがアプリケーションでサポートされている最低バージョンよりも低い場合、アプリケーションは初期化に失敗するか、システム上の別の Windows APPC DLL を見つけようとします。

このネゴシエーションにより、Windows APPC DLL と Windows APPC アプリケーションの両方で、さまざまな Windows APPC バージョンをサポートできます。 バージョンに重複がある場合、アプリケーションは DLL を正常に使用できます。 次の表は、 WinAPPCStartup がさまざまなアプリケーションおよび DLL バージョンと連携して動作する方法を示しています。

アプリケーションのバージョン	DLL のバージョン	WinAPPCStartup へ	WinAPPCStartup から	結果
1.0	1.0	1.0	1.0	1.0 を使用する
1.0、2.0	1.0	2.0	1.0	1.0 を使用する
1.0	1.0、2.0	1.0	2.0	1.0 を使用する
1.0	2.0, 3.0	1.0	WAPPCINVALID	失敗
2.0, 3.0	1.0	3.0	1.0	アプリが失敗する
1.0, 2.0, 3.0	1.0, 2.0, 3.0	3.0	3.0	3.0 を使用する

実際の Windows APPC 実装の詳細については、WinAPPCStartup によって返される次のように定義された WAPPCDATA 構造体で説明されています。

typedef struct tagWAPPCDDATA { WORD wVersion;  
char szDescription[WAPPCDESCRIPTION_LEN+1];  
} WAPPCDATA, FAR *LPWAPPCDATA;  

構造体のメンバーは次のとおりです。

wVersion
Windows APPC DLL でサポートされている最も高い APPC バージョン番号。

szDescription
WinAPPC 実装を説明する説明文字列。

最後の Windows APPC 呼び出しを行った後、アプリケーションは WinAPPCCleanup ルーチンを呼び出す必要があります。

各 Windows APPC 実装では、他の Windows APPC 呼び出しを発行する前に WinAPPCStartup 呼び出しを行う必要があります。