IShellLinkDataList::CopyDataBlock method

Retrieves a copy of a link's data block.

Syntax


HRESULT CopyDataBlock(
  [in]   DWORD dwSig,
  [out]  VOID **ppDataBlock
);

Parameters

dwSig [in]

Type: DWORD

The data block's signature. The signature value for a particular type of data block can be found in its structure reference. For a list of supported data block types and their associated structures, see IShellLinkDataList.

ppDataBlock [out]

Type: VOID**

The address of a pointer to a copy of the data block structure. If IShellLinkDataList::CopyDataBlock returns a successful result, the calling application must free the memory when it is no longer needed by calling LocalFree.

Return value

Type: HRESULT

Returns S_OK if successful, or a COM error code otherwise.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

DLL

Shell32.dll (version 5.0 or later)

See also

IShellLinkDataList

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.