IDataObject.GetDataHere

.NET Framework クラス ライブラリ リファレンス

IDataObject.GetDataHere メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した pFormatEtc 構造体で記述されるデータを表示し、b パラメータに転送します。

名前空間: Microsoft.Aspnet.Snapin
アセンブリ: AspNetMMCExt (aspnetmmcext.dll 内)
構文

Visual Basic (宣言)

Function GetDataHere ( _
    ByRef pFormatEtc As FORMATETC, _
    ByRef b As STGMEDIUM _
) As Integer

Visual Basic (使用法)

Dim instance As IDataObject
Dim pFormatEtc As FORMATETC
Dim b As STGMEDIUM
Dim returnValue As Integer

returnValue = instance.GetDataHere(pFormatEtc, b)

C#

int GetDataHere (
    ref FORMATETC pFormatEtc,
    ref STGMEDIUM b
)

C++

int GetDataHere (
    FORMATETC% pFormatEtc, 
    STGMEDIUM% b
)

J#

int GetDataHere (
    /** @ref */ FORMATETC pFormatEtc, 
    /** @ref */ STGMEDIUM b
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

pFormatEtc

データを取得するための呼び出しの形式、メディア、および対象デバイスを定義する FORMATETC へのポインタ。

b

返されたデータを格納しているストレージ メディアを示す STGMEDIUM へのポインタ。

戻り値
GetDataHere メソッドは、標準の戻り値である E_INVALIDARG、E_UNEXPECTED、および E_OUTOFMEMORY をサポートすると同時に、次の戻り値もサポートしています。

戻り値	説明
S_OK	GetDataHere メソッドのこの呼び出しでデータが正常に取得され、指定したストレージ メディアに格納されました。
DV_E_LINDEX	lindex が有効ではありません。
DV_E_FORMATETC	pFormatEtc が有効ではありません。
DV_E_TYMED	tymed が有効ではありません。
DV_E_DVASPECT	dwAspect が有効ではありません。
OLE_E_NOTRUNNING	オブジェクト アプリケーションが実行されていません。
STG_E_MEDIUMFULL	メディアの割り当て中にエラーが発生しました。

解説

GetDataHere メソッドは、指定したストレージ メディアの割り当てと解放を呼び出し元で行う必要があるという点で、GetData メソッドと異なります。

IDataObject インターフェイスを使用したプログラミングおよび Microsoft 管理コンソール (MMC) の詳細については、MSDN ライブラリにある『MMC Programmer's Guide』を参照してください。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IDataObject インターフェイス
IDataObject メンバ
Microsoft.Aspnet.Snapin 名前空間

IDataObject.GetDataHere メソッド

このメソッドは、.NET Framework インフラストラクチャをサポートします。独自に作成したコードから直接使用するためのものではありません。

名前空間: Microsoft.CLRAdmin
アセンブリ: mscorcfg (mscorcfg.dll 内)
構文

Visual Basic (宣言)

Function GetDataHere ( _
    ByRef pFormatEtc As FORMATETC, _
    ByRef b As STGMEDIUM _
) As Integer

Visual Basic (使用法)

Dim instance As IDataObject
Dim pFormatEtc As FORMATETC
Dim b As STGMEDIUM
Dim value As Integer

value = instance.GetDataHere(pFormatEtc, b)

C#

int GetDataHere (
    ref FORMATETC pFormatEtc,
    ref STGMEDIUM b
)

C++

int GetDataHere (
    FORMATETC% pFormatEtc, 
    STGMEDIUM% b
)

J#

int GetDataHere (
    /** @ref */ FORMATETC pFormatEtc, 
    /** @ref */ STGMEDIUM b
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

pFormatEtc

b

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 1.1、1.0

参照

関連項目
IDataObject インターフェイス
IDataObject メンバ
Microsoft.CLRAdmin 名前空間

IDataObject.GetDataHere メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ソース データ オブジェクトからデータを取得します。このメソッドはデータ コンシューマによって呼び出され、呼び出し元が、指定したストレージ メディアを割り当て、解放する必要があるという点で GetData メソッドとは異なります。

名前空間: System.Runtime.InteropServices.ComTypes
アセンブリ: System (system.dll 内)
構文

Visual Basic (宣言)

Sub GetDataHere ( _
    <InAttribute> ByRef format As FORMATETC,
 _
    ByRef medium As STGMEDIUM _
)

Visual Basic (使用法)

Dim instance As IDataObject
Dim format As FORMATETC
Dim medium As STGMEDIUM

instance.GetDataHere(format, medium)

C#

void GetDataHere (
    [InAttribute] ref FORMATETC format,
    ref STGMEDIUM medium
)

C++

void GetDataHere (
    [InAttribute] FORMATETC% format, 
    STGMEDIUM% medium
)

J#

void GetDataHere (
    /** @attribute InAttribute() */ /** @ref */ FORMATETC format, 
    /** @ref */ STGMEDIUM medium
)

JScript

JScript では、値型の引数は参照渡しされません。

パラメータ

format

データを渡すときに使用する形式、メディア、および対象デバイスを定義する FORMATETC 構造体へのポインタ (参照渡し)。TYMED に指定できるのは 1 つのメディアだけです。また、有効な TYMED 値は、TYMED_ISTORAGE、TYMED_ISTREAM、TYMED_HGLOBAL、または TYMED_FILE だけです。

medium

転送されるデータを格納しているストレージ メディアを定義する STGMEDIUM (参照渡し)。メディアは、呼び出し元で割り当て、GetDataHere で情報を格納する必要があります。呼び出し元は、メディアを解放する必要もあります。このメソッドの実装では、常に、このパラメータが指している STGMEDIUM 構造体のpUnkForRelease メンバに null 参照 (Visual Basic では Nothing) 値を与える必要があります。

解説

IDataObject::GetDataHere の詳細については、MSDN ライブラリを参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IDataObject インターフェイス
IDataObject メンバ
System.Runtime.InteropServices.ComTypes 名前空間