PifMgr_GetProperties関数 (shlobj_core.h)

[PifMgr_GetProperties は、[要件] セクションで指定したオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。

.pif ファイルから指定したデータ ブロックを返します。

構文

int PifMgr_GetProperties(
  [in, optional]  HANDLE hProps,
  [in, optional]  PCSTR  pszGroup,
  [out, optional] void   *lpProps,
                  int    cbProps,
                  UINT   flOpt
);

パラメーター

[in, optional] hProps

型: HANDLE

アプリケーションのプロパティへのハンドル。 このパラメーターは、 PifMgr_OpenPropertiesによって返される値に設定する必要があります。

[in, optional] pszGroup

種類: PCSTR

プロパティ グループ名を含む null で終わる文字列。 次のいずれか、または有効な .pif 拡張子に対応するその他の名前を指定できます。

"WINDOWS 286 3.0"

"WINDOWS 386 3.0"

"WINDOWS VMM 4.0"

"WINDOWS NT 3.1"

"WINDOWS NT 4.0"

[out, optional] lpProps

型: void*

この関数が戻るときに、 には PROPPRG 構造体へのポインターが含まれます。

cbProps

型: int

lpProps が指すバッファーのサイズ (バイト単位)。

flOpt

型: UINT

このパラメーターを GETPROPS_NONE に設定します。

戻り値

型: int

成功した場合は NULL を 返します。 失敗した場合、関数は hProps として渡されたアプリケーション プロパティにハンドルを返します。

注釈

ブロックが "名前付き" ブロックの場合は、.pif ファイル内のリンクされた拡張子の名前である必要があります。 これには、任意の定義済みの名前 ("WINDOWS 386 3.0" など) または独自のブロックの名前を指定できます。 PifMgr_SetPropertiesを使用して、独自の名前付きデータ ブロックを作成できます。 名前付きデータは、変換なしで呼び出し元アプリケーションにそのまま返されるため、生データと考えることもできます。

名前付きブロックのサイズは、cbProps を 0 に設定してPifMgr_GetPropertiesを呼び出すことによって決定できます。 データはコピーされませんが、要求されたブロックのサイズが返されます。

pszGroupを NULL に設定することで、すべての名前付きブロックを列挙できます。 lpProps は、要求されたブロック名を含む 16 バイト バッファーへのポインターである必要があり、 cbProps は 0 から始まるブロック インデックスに設定する必要があります。 戻り値はブロックのサイズです。ブロックが見つからない場合は 0 です。

name パラメーターのセレクターを NULL に設定して名前のないプロパティ ブロックを要求し、オフセットがプロパティ グループ序数である場合は、関連付けられた構造体が返されます。 たとえば、PifMgr_GetProperties(GROUP_TSK) は、.pif ファイルに依存しない形式ですべてのタスク関連情報を含む定義済みの構造体を返します。 これは、呼び出し元のアプリケーションが、さまざまなセクション (.pif 拡張機能と呼ばれます) を含む .pif ファイルを処理するのを防ぎ、1 つだけが必要な場合に役立つサービスです。

要件

こちらもご覧ください

PifMgr_CloseProperties

PifMgr_OpenProperties