ホーム › Security.Cryptography.Certificates › CertSrvIsServerOnlineW
CertSrvIsServerOnlineW
関数証明書サービスサーバーがオンライン状態かどうかを確認する。
シグネチャ
// certadm.dll
#include <windows.h>
HRESULT CertSrvIsServerOnlineW(
LPCWSTR pwszServerName,
BOOL* pfServerOnline
);パラメーター
| 名前 | 型 | 方向 | 説明 |
|---|---|---|---|
| pwszServerName | LPCWSTR | in | 状態を確認する証明書サービスサーバの名前。NULL終端のワイド文字列で指定する。 |
| pfServerOnline | BOOL* | inout | サーバがオンラインならTRUEが返る出力ポインタ。 |
戻り値の型: HRESULT
各言語での呼び出し定義
// certadm.dll
#include <windows.h>
HRESULT CertSrvIsServerOnlineW(
LPCWSTR pwszServerName,
BOOL* pfServerOnline
);[DllImport("certadm.dll", ExactSpelling = true)]
static extern int CertSrvIsServerOnlineW(
[MarshalAs(UnmanagedType.LPWStr)] string pwszServerName, // LPCWSTR
ref bool pfServerOnline // BOOL* in/out
);<DllImport("certadm.dll", ExactSpelling:=True)>
Public Shared Function CertSrvIsServerOnlineW(
<MarshalAs(UnmanagedType.LPWStr)> pwszServerName As String, ' LPCWSTR
ByRef pfServerOnline As Boolean ' BOOL* in/out
) As Integer
End Function' pwszServerName : LPCWSTR
' pfServerOnline : BOOL* in/out
Declare PtrSafe Function CertSrvIsServerOnlineW Lib "certadm" ( _
ByVal pwszServerName As LongPtr, _
ByRef pfServerOnline As Long) As Long
' VBA7前提(PtrSafe)。32bit Office では LongPtr→Long。Integer=16bit / Long=32bit / LongLong=64bit。import ctypes
from ctypes import wintypes
CertSrvIsServerOnlineW = ctypes.windll.certadm.CertSrvIsServerOnlineW
CertSrvIsServerOnlineW.restype = ctypes.c_int
CertSrvIsServerOnlineW.argtypes = [
wintypes.LPCWSTR, # pwszServerName : LPCWSTR
ctypes.c_void_p, # pfServerOnline : BOOL* in/out
]require 'fiddle'
require 'fiddle/import'
lib = Fiddle.dlopen('certadm.dll')
CertSrvIsServerOnlineW = Fiddle::Function.new(
lib['CertSrvIsServerOnlineW'],
[
Fiddle::TYPE_VOIDP, # pwszServerName : LPCWSTR
Fiddle::TYPE_VOIDP, # pfServerOnline : BOOL* in/out
],
Fiddle::TYPE_INT)#[link(name = "certadm")]
extern "system" {
fn CertSrvIsServerOnlineW(
pwszServerName: *const u16, // LPCWSTR
pfServerOnline: *mut i32 // BOOL* in/out
) -> i32;
}
// crates: windows-sys provides ready-made bindings for this API.$sig = @"
[DllImport("certadm.dll")]
public static extern int CertSrvIsServerOnlineW([MarshalAs(UnmanagedType.LPWStr)] string pwszServerName, ref bool pfServerOnline);
"@
$api = Add-Type -MemberDefinition $sig -Name 'certadm_CertSrvIsServerOnlineW' -Namespace Win32 -PassThru
# $api::CertSrvIsServerOnlineW(pwszServerName, pfServerOnline)#uselib "certadm.dll"
#func global CertSrvIsServerOnlineW "CertSrvIsServerOnlineW" sptr, sptr
; CertSrvIsServerOnlineW pwszServerName, varptr(pfServerOnline) ; 戻り値は stat
; pwszServerName : LPCWSTR -> "sptr"
; pfServerOnline : BOOL* in/out -> "sptr"
; ※HSP3.7は #func のため戻り値はシステム変数 stat に格納されます。出力引数:
#uselib "certadm.dll" #cfunc global CertSrvIsServerOnlineW "CertSrvIsServerOnlineW" wstr, var ; res = CertSrvIsServerOnlineW(pwszServerName, pfServerOnline) ; pwszServerName : LPCWSTR -> "wstr" ; pfServerOnline : BOOL* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。#uselib "certadm.dll" #cfunc global CertSrvIsServerOnlineW "CertSrvIsServerOnlineW" wstr, sptr ; res = CertSrvIsServerOnlineW(pwszServerName, varptr(pfServerOnline)) ; pwszServerName : LPCWSTR -> "wstr" ; pfServerOnline : BOOL* in/out -> "sptr" ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
出力引数:
; HRESULT CertSrvIsServerOnlineW(LPCWSTR pwszServerName, BOOL* pfServerOnline) #uselib "certadm.dll" #cfunc global CertSrvIsServerOnlineW "CertSrvIsServerOnlineW" wstr, var ; res = CertSrvIsServerOnlineW(pwszServerName, pfServerOnline) ; pwszServerName : LPCWSTR -> "wstr" ; pfServerOnline : BOOL* in/out -> "var" ; ※出力/バッファ引数は var 方式(変数を直接渡す)。varptr 方式にも切替可。; HRESULT CertSrvIsServerOnlineW(LPCWSTR pwszServerName, BOOL* pfServerOnline) #uselib "certadm.dll" #cfunc global CertSrvIsServerOnlineW "CertSrvIsServerOnlineW" wstr, intptr ; res = CertSrvIsServerOnlineW(pwszServerName, varptr(pfServerOnline)) ; pwszServerName : LPCWSTR -> "wstr" ; pfServerOnline : BOOL* in/out -> "intptr" ; ※出力/バッファ引数はポインタ方式(token=intptr / 呼び出しは varptr(変数))。
import (
"golang.org/x/sys/windows"
"unsafe"
)
var (
certadm = windows.NewLazySystemDLL("certadm.dll")
procCertSrvIsServerOnlineW = certadm.NewProc("CertSrvIsServerOnlineW")
)
// pwszServerName (LPCWSTR), pfServerOnline (BOOL* in/out)
r1, _, err := procCertSrvIsServerOnlineW.Call(
uintptr(unsafe.Pointer(windows.StringToUTF16Ptr(pwszServerName))),
uintptr(pfServerOnline),
)
_ = err // syscall.Errno (valid when the call sets last-error)
_ = r1 // HRESULTfunction CertSrvIsServerOnlineW(
pwszServerName: PWideChar; // LPCWSTR
pfServerOnline: Pointer // BOOL* in/out
): Integer; stdcall;
external 'certadm.dll' name 'CertSrvIsServerOnlineW';result := DllCall("certadm\CertSrvIsServerOnlineW"
, "WStr", pwszServerName ; LPCWSTR
, "Ptr", pfServerOnline ; BOOL* in/out
, "Int") ; return: HRESULT●CertSrvIsServerOnlineW(pwszServerName, pfServerOnline) = DLL("certadm.dll", "int CertSrvIsServerOnlineW(char*, void*)")
# 呼び出し: CertSrvIsServerOnlineW(pwszServerName, pfServerOnline)
# pwszServerName : LPCWSTR -> "char*"
# pfServerOnline : BOOL* in/out -> "void*"
# なでしこ1は32bit・ANSI(Shift_JIS)。文字列=char*(ANSI)、ポインタ/ハンドル=void*(4byte)。const std = @import("std");
extern "certadm" fn CertSrvIsServerOnlineW(
pwszServerName: [*c]const u16, // LPCWSTR
pfServerOnline: [*c]i32 // BOOL* in/out
) callconv(std.os.windows.WINAPI) i32;proc CertSrvIsServerOnlineW(
pwszServerName: WideCString, # LPCWSTR
pfServerOnline: ptr int32 # BOOL* in/out
): int32 {.importc: "CertSrvIsServerOnlineW", stdcall, dynlib: "certadm.dll".}pragma(lib, "certadm");
extern(Windows)
int CertSrvIsServerOnlineW(
const(wchar)* pwszServerName, // LPCWSTR
int* pfServerOnline // BOOL* in/out
);ccall((:CertSrvIsServerOnlineW, "certadm.dll"), stdcall, Int32,
(Cwstring, Ptr{Int32}),
pwszServerName, pfServerOnline)
# pwszServerName : LPCWSTR -> Cwstring
# pfServerOnline : BOOL* in/out -> Ptr{Int32}
# stdcall は 32bit のみ意味を持つ(x64 では無視)。local ffi = require("ffi")
ffi.cdef[[
int32_t CertSrvIsServerOnlineW(
const uint16_t* pwszServerName,
int32_t* pfServerOnline);
]]
local certadm = ffi.load("certadm")
-- certadm.CertSrvIsServerOnlineW(pwszServerName, pfServerOnline)
-- pwszServerName : LPCWSTR
-- pfServerOnline : BOOL* in/out
-- 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。const koffi = require('koffi');
const lib = koffi.load('certadm.dll');
const CertSrvIsServerOnlineW = lib.func('__stdcall', 'CertSrvIsServerOnlineW', 'int32_t', ['str16', 'int32_t *']);
// CertSrvIsServerOnlineW(pwszServerName, pfServerOnline)
// pwszServerName : LPCWSTR -> 'str16'
// pfServerOnline : BOOL* in/out -> 'int32_t *'
// 出力ポインタは koffi.out(...) で包む。構造体は koffi.struct で定義。const lib = Deno.dlopen("certadm.dll", {
CertSrvIsServerOnlineW: { parameters: ["buffer", "pointer"], result: "i32" },
});
// lib.symbols.CertSrvIsServerOnlineW(pwszServerName, pfServerOnline)
// pwszServerName : LPCWSTR -> "buffer"
// pfServerOnline : BOOL* in/out -> "pointer"
// 文字列引数は "buffer"(NUL 終端のバイト列を Uint8Array で渡す)。
// 値渡し構造体は { struct: [ ...field types... ] } を使用。<?php
$ffi = FFI::cdef(<<<C
int32_t CertSrvIsServerOnlineW(
const uint16_t* pwszServerName,
int32_t* pfServerOnline);
C, "certadm.dll");
// $ffi->CertSrvIsServerOnlineW(pwszServerName, pfServerOnline);
// pwszServerName : LPCWSTR
// pfServerOnline : BOOL* in/out
// 構造体/GUIDへのポインタは cdef が通るよう void* で表記(実型は各引数コメント参照)。値渡し構造体・enum は対応する typedef を cdef に追加すること。
// WINAPI(stdcall): x64 では呼出規約が統一されるため問題なし。x86 では __stdcall 対応のラッパが必要な場合あり。import com.sun.jna.*;
import com.sun.jna.ptr.*;
import com.sun.jna.win32.StdCallLibrary;
import com.sun.jna.win32.W32APIOptions;
public interface Certadm extends StdCallLibrary {
Certadm INSTANCE = Native.load("certadm", Certadm.class);
int CertSrvIsServerOnlineW(
WString pwszServerName, // LPCWSTR
IntByReference pfServerOnline // BOOL* in/out
);
}@[Link("certadm")]
lib Libcertadm
fun CertSrvIsServerOnlineW = CertSrvIsServerOnlineW(
pwszServerName : UInt16*, # LPCWSTR
pfServerOnline : Int32* # BOOL* in/out
) : Int32
end
# 構造体/GUID/enum は lib 内に対応する型定義が必要。
# 呼出規約: x64 は規約統一のため OK。x86(32bit)は WINAPI=stdcall だが Crystal の fun に stdcall 付与構文がなく非対応。import 'dart:ffi';
import 'package:ffi/ffi.dart';
typedef CertSrvIsServerOnlineWNative = Int32 Function(Pointer<Utf16>, Pointer<Int32>);
typedef CertSrvIsServerOnlineWDart = int Function(Pointer<Utf16>, Pointer<Int32>);
final CertSrvIsServerOnlineW = DynamicLibrary.open('certadm.dll')
.lookupFunction<CertSrvIsServerOnlineWNative, CertSrvIsServerOnlineWDart>('CertSrvIsServerOnlineW');
// pwszServerName : LPCWSTR -> Pointer<Utf16>
// pfServerOnline : BOOL* in/out -> Pointer<Int32>
// 文字列は package:ffi の "...".toNativeUtf16()/toNativeUtf8() で変換。{$mode objfpc}{$H+}
function CertSrvIsServerOnlineW(
pwszServerName: PWideChar; // LPCWSTR
pfServerOnline: Pointer // BOOL* in/out
): Integer; stdcall;
external 'certadm.dll' name 'CertSrvIsServerOnlineW';import Foreign
import Foreign.C.Types
import Foreign.C.String
foreign import stdcall safe "CertSrvIsServerOnlineW"
c_CertSrvIsServerOnlineW :: CWString -> Ptr CInt -> IO Int32
-- pwszServerName : LPCWSTR -> CWString
-- pfServerOnline : BOOL* in/out -> Ptr CInt
-- 要 GHC(Windows)。stdcall は x64 では ccall として扱われる。ブロックする API は safe 呼び出し推奨。open Ctypes
open Foreign
let certsrvisserveronlinew =
foreign "CertSrvIsServerOnlineW"
((ptr uint16_t) @-> (ptr int32_t) @-> returning int32_t)
(* pwszServerName : LPCWSTR -> (ptr uint16_t) *)
(* pfServerOnline : BOOL* in/out -> (ptr int32_t) *)
(* foreign は cdecl 前提。x64 Windows では WINAPI と一致。構造体は ctypes structure を定義のこと。 *)(cffi:define-foreign-library certadm (t "certadm.dll"))
(cffi:use-foreign-library certadm)
(cffi:defcfun ("CertSrvIsServerOnlineW" cert-srv-is-server-online-w :convention :stdcall) :int32
(pwsz-server-name (:string :encoding :utf-16le)) ; LPCWSTR
(pf-server-online :pointer)) ; BOOL* in/out
; isize/usize(INT_PTR/SIZE_T)は x64 前提で :int64/:uint64。x86 では :int32/:uint32。use Win32::API;
my $CertSrvIsServerOnlineW = Win32::API::More->new('certadm',
'int CertSrvIsServerOnlineW(LPCWSTR pwszServerName, LPVOID pfServerOnline)');
# my $ret = $CertSrvIsServerOnlineW->Call($pwszServerName, $pfServerOnline);
# pwszServerName : LPCWSTR -> LPCWSTR
# pfServerOnline : BOOL* in/out -> LPVOID
# 値渡し構造体は pack() した文字列、または Win32::API::Struct を使用。