windows-nt/Source/XPSP1/NT/net/config/shell/folder/shutil.h

127 lines
3.3 KiB
C
Raw Normal View History

2020-09-26 03:20:57 -05:00
//+---------------------------------------------------------------------------
//
// Microsoft Windows
// Copyright (C) Microsoft Corporation, 1997.
//
// File: S H U T I L . H
//
// Contents: Various shell utilities to be used by the connections folder
//
// Notes:
//
// Author: jeffspr 21 Oct 1997
//
//----------------------------------------------------------------------------
#pragma once
#ifndef _SHUTIL_H_
#define _SHUTIL_H_
#include <ndispnp.h>
#include <ntddndis.h>
#include <ncshell.h>
HRESULT HrDupeShellStringLength(
PCWSTR pszInput,
ULONG cchInput,
PWSTR * ppszOutput);
inline
HRESULT HrDupeShellString(
PCWSTR pszInput,
PWSTR * ppszOutput)
{
return HrDupeShellStringLength(pszInput, wcslen(pszInput), ppszOutput);
}
HRESULT HrGetConnectionPidlWithRefresh(const GUID& guidId,
PCONFOLDPIDL& ppidlCon);
//---[ Various refresh functions ]--------------------------------------------
// Notify the shell that an object is going away, and remove it from our list
//
HRESULT HrDeleteFromCclAndNotifyShell(
const PCONFOLDPIDLFOLDER& pidlFolder,
const PCONFOLDPIDL& pidlConnection,
const CONFOLDENTRY& ccfe);
VOID ForceRefresh(HWND hwnd);
// Update the folder, but don't flush the items. Update them as needed.
// pidlFolder is optional -- if not passed in, we'll generate it.
//
HRESULT HrForceRefreshNoFlush(const PCONFOLDPIDLFOLDER& pidlFolder);
// Update the connection data based on the pidl. Notify the shell as
// appropriate
//
HRESULT HrOnNotifyUpdateConnection(
const PCONFOLDPIDLFOLDER& pidlFolder,
const GUID * pguid,
NETCON_MEDIATYPE ncm,
NETCON_SUBMEDIATYPE ncsm,
NETCON_STATUS ncs,
DWORD dwCharacteristics,
PCWSTR pszwName,
PCWSTR pszwDeviceName,
PCWSTR pszwPhoneNumberOrHostAddress);
// Update the connection status, including sending the correct shell
// notifications for icon updates and such.
//
HRESULT HrOnNotifyUpdateStatus(
const PCONFOLDPIDLFOLDER& pidlFolder,
const PCONFOLDPIDL& pidlCached,
NETCON_STATUS ncsNew);
// update the shell/connection list with the new connection status
//
HRESULT HrUpdateConnectionStatus(
const PCONFOLDPIDL& pcfp,
NETCON_STATUS ncs,
const PCONFOLDPIDLFOLDER& pidlFolder,
BOOL fUseCharacter,
DWORD dwCharacter);
//---[ Menu merging functions ]-----------------------------------------------
VOID MergeMenu(
HINSTANCE hinst,
UINT idMainMerge,
UINT idPopupMerge,
LPQCMINFO pqcm);
INT IMergePopupMenus(
HMENU hmMain,
HMENU hmMerge,
int idCmdFirst,
int idCmdLast);
HRESULT HrGetMenuFromID(
HMENU hmenuMain,
UINT uID,
HMENU * phmenu);
HRESULT HrLoadPopupMenu(
HINSTANCE hinst,
UINT id,
HMENU * phmenu);
HRESULT HrShellView_GetSelectedObjects(
HWND hwnd,
PCONFOLDPIDLVEC& apidlSelection);
HRESULT HrRenameConnectionInternal(
const PCONFOLDPIDL& pidlCon,
const PCONFOLDPIDLFOLDER& pidlFolder,
LPCWSTR pszNewName,
BOOL fRaiseError,
HWND hwndOwner,
PCONFOLDPIDL& ppidlOut);
#endif // _SHUTIL_H_