IDockingWindowSite::RequestBorderSpaceDW method

Approves, modifies, or refuses a request for an IDockingWindow object's border space. The border space is not allocated until the SetBorderSpaceDW method is called.

Syntax

HRESULT RequestBorderSpaceDW(
  IUnknown        *punkObj,
  LPCBORDERWIDTHS pbw
);

Parameters

punkObj

Type: IUnknown*

Pointer to the IDockingWindow object for which the border space is being requested.

pbw

Type: LPCBORDERWIDTHS

A pointer to a BORDERWIDTHS structure. Before calling this method, the structure must be filled with the desired border space. After the method returns successfully, the structure contains the approved border space. The IDockingWindowSite object may change these values. If border space is critical, it is the caller's responsibility to determine if the returned border space is sufficient.

Return Value

Type: HRESULT

Returns S_OK if the border space request is approved or modified, or an error value otherwise.

Requirements

   
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj_core.h
DLL Shell32.dll (version 4.71 or later)

See Also

IDockingWindowFrame

IDockingWindowSite