GetStateTextA 関数 (oleacc.h)

1 つの定義済み状態ビット フラグのオブジェクトの状態を記述するローカライズされた文字列を取得します。 状態値は 1 つ以上のビット フラグの組み合わせであるため、クライアントはこの関数を複数回呼び出してすべての状態文字列を取得します。

構文

UINT GetStateTextA(
  [in]  DWORD lStateBit,
  [out] LPSTR lpszState,
  [in]  UINT  cchState
);

パラメーター

[in] lStateBit

種類: DWORD

オブジェクト状態定数の 1 つ。

[out] lpszState

種類: LPTSTR

状態テキスト文字列を受け取るバッファーのアドレス。 このパラメーターが NULL の場合、この関数は null 文字を含まない状態文字列の長さを返します。

[in] cchState

型: UINT

lpszStateBit パラメーターによって指されるバッファーのサイズ。 ANSI 文字列の場合、この値はバイト単位で測定されます。Unicode 文字列の場合は、文字で測定されます。

戻り値

型: UINT

成功した場合、 lpszStateBit が NULL 以外の場合、戻り値は、バッファーにコピーされるバイト数 (ANSI 文字列) または文字 (Unicode 文字列) であり、null で終わる文字は含まれません。 lpszStateBit が NULL の場合、戻り値は null 文字を含まない文字列の長さを表します。

文字列リソースが存在しない場合、または lpszStateBit パラメーターが有効なポインターでない場合、戻り値は 0 になります。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

この関数は、ビットマスクではなく、一度に 1 つの状態ビットのみを受け入れます。

要件