次の方法で共有

RasGetCountryInfoA 関数 (ras.h)

  • [アーティクル]

RasGetCountryInfo 関数は、国/地域の Windows テレフォニー リストから国/地域固有のダイヤル情報を取得します。

国/地域固有のダイヤル情報と テレフォニー アプリケーション プログラミング インターフェイス (TAPI) 国/地域識別子の詳細については、プラットフォーム ソフトウェア開発キット (SDK) の TAPI の部分を参照してください。

構文

DWORD RasGetCountryInfoA(
  [in, out] LPRASCTRYINFOA unnamedParam1,
  [in, out] LPDWORD        unnamedParam2
);

パラメーター

[in, out] unnamedParam1

出力時に国/地域固有のダイヤル情報を受け取り、その後に国/地域の説明文字列の追加バイトが続く、RASCTRYINFO 構造体へのポインター。

入力時に、構造体の dwSize メンバーを sizeof(RASCTRYINFO) に設定して、構造体のバージョンを識別します。 また、dwCountryId メンバーを、情報を取得する国/地域の TAPI 国/地域識別子に設定します。

バッファーに少なくとも 256 バイトを割り当てます。

[in, out] unnamedParam2

入力時に、lpRasCtryInfo パラメーターによって指されるバッファーのサイズをバイト単位で指定する変数へのポインター。

出力時に、この変数は必要なバイト数を受け取ります。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS。

関数が失敗した場合、戻り値は次のいずれかのエラー コード、または Routing と Remote Access Error Codes または Winerror.h からの値です。

価値 意味
ERROR_INVALID_USER_BUFFER
 lpRasCtryInfo で指定 アドレスまたはバッファーが無効です。
ERROR_INVALID_PARAMETER
 dwCountryId lpRasCtryInfo が指す構造体 メンバーが有効な値ではありません。
ERROR_BUFFER_TOO_SMALL
 lpdwSize パラメーターで指定された lpRasCtryInfo バッファーのサイズが、dwCountryId メンバーによって識別される国/地域の情報を格納するのに十分な大きさではなかった。 この関数は、lpdwSizeが指す変数 必要なバッファー サイズを返します。
ERROR_TAPI_CONFIGURATION
 TAPI サブシステム情報が破損しています。

備考

Windows テレフォニー リスト内のすべての国/地域の情報を列挙するには、最初の RasGetCountryInfo 呼び出しで、RASCTRYINFO 構造体の dwCountryId メンバーを 1 に設定します。 これにより、関数はリスト内の最初の国/地域の情報を返します。 dwNextCountryID メンバーで返される値は、リスト内の次の国/地域の国/地域識別子です。 この値は、dwNextCountryID が 0 を返すまで RasGetCountryInfo を繰り返し呼び出す場合に使用します。これは、リスト内の最後の国/地域を示します。

手記

ras.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして RasGetCountryInfo を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ras.h
ライブラリ Rasapi32.lib
DLL Rasapi32.dll

関連項目

RASCTRYINFO を する

リモート アクセス サービス (RAS) の概要

リモート アクセス サービス関数 の